Babli CLI

Use Babli.ai from your commandline. Sync your project with Babli.

Use

When you have new keys to translate. Add them to one of your translation files. And then

• run babli login if you haven't already
• babli push - push new keys/translations to Babli.ai
• translate them on babli.ai
• babli pull - pull the new translations to your project

Install

npm install -g babli

Workspace development

Terminal 1:

cd apps/cli
npm link
cd ../..
pnpm cli:watch

Terminal 2:

chmod +x apps/cli/dist/index.js
hash -r
babli --version

babli --version should show a -dev suffix while you are using the local watch build, plus the repo root folder name so you can tell which worktree is linked.

If you see zsh: permission denied: babli, rerun chmod +x apps/cli/dist/index.js.

If you only need a one-time local install snapshot, use:

pnpm cli:install-local

Release

CLI releases are published from GitHub Actions with npm trusted publishing.

1. Bump apps/cli/package.json version in a normal PR.
2. Merge to main.
3. Create and push a tag that matches the CLI version:

git tag cli-v0.0.18
git push origin cli-v0.0.18

The publish workflow:

• only runs for cli-v* tags
• verifies the tag matches apps/cli/package.json
• runs CLI and shared-package checks
• publishes apps/cli to npm from CI

Before this works, configure npm trusted publishing for the babli package to trust:

• repository: this repo
• workflow file: publish-cli.yml
• environment: npm-publish

If the version is a prerelease such as 0.1.0-beta.1, CI publishes it under the matching npm dist-tag such as beta.

Use in CI

• set BABLI_API_KEY env variable (find it in your project settings)
• run babli pull to pull translations from babli.ai

Automatic Setup (coming soon)

create new Babli.ai project and connect it to your local project

babli create-project

Manual Setup

1. Create a babli.json or babli.yaml file in the root of your project
2. Create an empty project in babli.ai and get your projectId
3. Add your projectId and translation file path pattern

   {
     "projectId": "<your projectId>",
     "translationFiles": [{ "path": "src/translations/{{lang}}.json" }]
   }

4. Then you can push your keys from your project babli push