Skip to content
Sonenta

CLI (@sonenta/cli)

Complete reference for the @sonenta/cli command-line interface (v0.48.4). Auto-generated from source.

  • sonenta login - Sign in to Sonenta. Default: account login via the browser (device flow): the session used by projects create / api-keys create. With --token: store an API key (Authorization: ApiKey) for runtime/MCP + content commands.
  • sonenta logout - Remove stored credentials for a host (default: the current default host).
  • sonenta whoami - Show the configured default host + which API key is in use.
  • sonenta init - Scaffold sonenta.config.json AND write a managed Sonenta block into CLAUDE.md / AGENTS.md so coding agents know how this repo uses Sonenta.
  • sonenta projects - Inspect and create Sonenta projects.
  • sonenta keys - Inspect translation keys for the current project.
  • sonenta import - Import i18next JSON file(s) into Sonenta in ONE call: creates missing keys and upserts translations (idempotent). Accepts nested or flat JSON. Language/namespace are inferred from the path (/.json) or forced with --language / --namespace.
  • sonenta push - Push the whole local locales/ tree to Sonenta, BATCHED: creates missing keys and upserts translations (idempotent). Reads locales//.json (flat dot-notation). Each key carries all its languages in one batch, so the source value is never split from its translations.
  • sonenta pull - Pull translations from Sonenta into locales//.json (flat dot-notation). Overwrites local files: pair with git status.
  • sonenta export - Export translations as i18next JSON (default) or XLIFF (--format xliff). JSON is flat dot-notation by default (--nested for nested trees). Writes //.json with --out, otherwise prints { locale: { namespace: tree } } to stdout.
  • sonenta status - Diff local locales/ against the remote project state.
  • sonenta releases - Manage CDN releases for the project.
  • sonenta snapshot - Generate a build-time translations snapshot for @sonenta/react-i18next initialBundles (offline-first fallback). Fetches the PUBLIC CDN bundles (exactly what the SDK loads at runtime) and assembles Record<locale, Record<namespace, tree>>. Emits a .ts module (default) or .json.
  • sonenta missing - List runtime-detected missing keys for the configured project. Requires the API key to carry the mcp:* scope.
  • sonenta agents - Install bundled Claude agents (e.g. sonenta-a11y) into .claude/agents/.
  • sonenta doctor - Preflight the agent setup: verifies the @sonenta/mcp server is wired + reachable, the key has the mcp:* scope, and the project's a11y tools respond, with an exact fix for anything that's off.