Skip to main content
Glama

locli

Localize your app with your coding agent. locli is the one place for the texts of your iOS, Android, web and backend app and its store listings. Your agent moves the texts into the app's catalog, uploads and translates them; locli checks every one; nothing ships until a person approves the release.

locli context: cart_checkout is a toolbar item of about 12 characters, the German translation has 28

How it works

  1. Your agent writes the texts where they belong: Localizable.xcstrings, strings.xml or ICU JSON, under stable keys like cart_checkout, never hard-coded strings.

  2. locli push uploads new keys and texts and never overwrites what translators changed.

  3. The agent translates with your project's tone, glossary and the place each text appears. locli context finds that place in the code: a toolbar item fits about 12 characters, a screen title about 24. Placeholders, plurals and glossary terms are checked on every upload.

  4. You approve a release in the locli web app: each changed text with a diff, then the release as a whole.

  5. locli pull writes exactly that release into the app. Builds stay reproducible.

Works with Claude Code, Cursor, Codex and any MCP client; no lock-in to one agent.

This repository holds what runs on your machine:

Folder

What

cli/

@locli/cli: init, login, push, pull, status, context, areas, guide and the MCP server (npx -y @locli/cli mcp)

plugin/

The Claude Code plugin: a skill that tells the agent when and how to use locli, plus the MCP server

cli/skill/

The full agent skill that locli init installs into a repository

Related MCP server: i1n

Get started

In your app's repository:

npx @locli/cli init

Or ask your coding agent: "Set up locli for this app's texts." (docs: https://locli.dev/docs/agents.md).

Claude Code

/plugin marketplace add mariohahn/locli
/plugin install locli@locli

Cursor, Codex and other MCP clients

{ "mcpServers": { "locli": { "command": "npx", "args": ["-y", "@locli/cli", "mcp"] } } }

Sign in once with npx @locli/cli login (it opens the browser to approve the CLI). CI uses a project token in LOCLI_TOKEN.

Data

The CLI and MCP server talk to one service: the locli server in locli.json (apiURL, default https://locli.dev, hosted in Frankfurt). They send the app's texts, their keys, comments and plural forms, and short usage notes such as "used as a toolbar item"; they do not send source code or file contents. Texts stay in the locli project until it is deleted. The sign-in token is stored in ~/.config/locli/credentials.json (or $XDG_CONFIG_HOME), readable only by you. Privacy policy: https://locli.dev/app/privacy/

Issues

Bugs and ideas: open an issue. The locli server and web app are not part of this repository.

License: MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-powered translation management built for AI agents. Automate localization with regional sensitivity and zero TMS overhead. Works with Claude Code, Cursor, VS Code via MCP protocol. Supports JSON, YAML, Markdown, PO and more.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      AI localization from your editor — translate an app's string files into 46 languages with placeholder-safe, reproducible output. Eleven formats (JSON, .arb, .po, .strings, Android XML and more), and every translation is read back and checked before it lands.
      7
      119 PyPI
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets a coding agent find, translate, validate and review an app's existing localization files (Android strings.xml, Apple String Catalogs, gettext) directly in the repo, supplying code usage, comments, glossary and voice notes as context. Placeholders, plural forms, escaping and markup are checked in code before any translation is written, and results land as reviewable drafts that never overwrite hand edits or approved work.
      1
      MIT