# easyi18n for AI agents

The [easyi18n](https://easyi18n.com) MCP server and the integrations that
install it. An agent connected to it can set up easyi18n in a Flutter, Xcode,
Angular, web or Android project, translate the strings and publish them.
With the developer's `easyi18n login` it spends and publishes as them; with
an agent key, every spend, publish and rollback it asks for waits until a
human approves it in the easyi18n dashboard.

| Directory | What it is |
|---|---|
| `claude-code/` | The Claude Code plugin: MCP server, `setup` and `translate` skills, `/easyi18n:doctor` |
| `clients/` | The MCP config snippet for every other client (Cursor, VS Code, Codex, Gemini CLI, and more) |
| `npm/` | `@easyi18n.com/cli`, the CLI as a prebuilt binary, for clients that launch the server with `npx` |
| `gemini-extension.json` | The Gemini CLI extension: the MCP server, launched with `npx` |
| `server.json` | The server's entry in the [MCP Registry](https://registry.modelcontextprotocol.io), `com.easyi18n/cli` |

## Claude Code

```
/plugin marketplace add easyi18n-com/agents
/plugin install easyi18n
```

The first session after the install downloads the CLI the plugin is pinned
to, verified against its release's `SHA256SUMS`. An `easyi18n` or
`dart pub global run easyi18n_cli:easyi18n` of that same version is used
instead when one is installed.

The plugin uses the login `easyi18n login` stores: run it once in a
terminal. For an agent that must not spend without your approval, give the
plugin an agent key instead, from its configuration: `/plugin`, then
easyi18n, then Configure. Create the key in the dashboard under Project >
Settings > API keys > New API key, with Used by set to AI agent. The `setup`
skill runs before either exists and tells you what to do. Check the connection with `/mcp`.

A team that works across several easyi18n projects can give each repository
its own key in place of the plugin: a `.mcp.json` at the project root that
takes the key from the environment Claude Code was started in.

```json
{
  "mcpServers": {
    "easyi18n": {
      "command": "npx",
      "args": ["-y", "@easyi18n.com/cli@1.2.2", "mcp"],
      "env": { "EASYI18N_TOKEN": "${EASYI18N_TOKEN}" }
    }
  }
}
```

## Gemini CLI

```
gemini extensions install https://github.com/easyi18n-com/agents
```

The extension starts the server with `npx`, so it needs Node.js, and uses
the login `easyi18n login` stores. For an agent key, use the Gemini CLI
snippet in [`clients/README.md`](clients/README.md) instead.

## Other clients

[`clients/README.md`](clients/README.md) has the snippet for each client,
the same text `easyi18n mcp config --client <client>` prints.

## Source

This repository is a one-way mirror of `integrations/agents/` in the easyi18n
monorepo. The skills are generated from the MCP server's prompts, and the
client snippets, `gemini-extension.json` and `server.json` from the CLI, so
a change made here is overwritten by the next sync. Report issues at https://github.com/easyi18n-com/agents/issues.