@lingpie/cli

Command-line client for the LingPie integration REST API (/integrations/v1).

Sync locale files with your LingPie project using lingpie.yaml at your repository root. Works with the same config as @lingpie/mcp-server for AI-agent workflows.

Requires Node.js ≥ 20.

Install

npm install -g @lingpie/cli
# or run without installing:
npx lingpie --help

Quick start

1. Create a project API key in the LingPie dashboard (lp_…).
2. Initialize config in your app repo:

export LINGPIE_API_KEY=lp_...
npx lingpie init 42 "My App"
# or: npx lingpie init --project-id 42 --name "My App"

3. Review generated lingpie.yaml (especially files[]), then sync:

npx lingpie pull
npx lingpie push

Commands

| Command | Description | |---------|-------------| | init <project-id> <name> | Create lingpie.yaml with auto-detected locale files | | pull | Export translations from LingPie into local files | | push | Import local files into LingPie | | keys list | List translation keys | | languages list / add / edit / remove | Manage project languages |

Global flag: --json for machine-readable output.

Filter pull / push with repeatable --alias, --path, and --language. Use --on-conflict overwrite|keep-server on push.

CI example

Pull before your app build so bundled assets include the latest translations:

export LINGPIE_API_KEY=lp_...
npx lingpie pull
# then run your app's build (npm run build, ./gradlew assemble, xcodebuild, …)

License

MIT — see LICENSE.