CLI Reference

Commands

All CLI commands, flags, and exit codes. Install the CLI with npm install -g pronto-cli.

inittranslatestatuswhoamiloginlogout

pronto init

Scan the current project for translatable strings and generate a pronto.config.json. Detects your framework automatically. Run once per project.

$ pronto init [options]

Flags

--framework <name>Override framework detection (nextjs, vue, wordpress, webflow, etc.)
--locales-dir <path>Override where locale files are written(default: ./public/locales)
--source-locale <lang>Source language code(default: en)
--dry-runPrint discovered strings without writing config

Exit Codes

0Success
1No translatable strings found
2Framework not recognized — use --framework

Example

$ pronto init --framework wordpress --locales-dir ./languages

pronto translate

Translate strings that changed since the last run. Shows cost estimate before proceeding. Uses your Pronto translation memory to skip previously translated strings.

$ pronto translate [options]

Flags

--target <langs>Comma-separated target language codes (e.g. es,ja,fr)(default: from config)
--allRe-translate all strings, not just changed ones
--auto-approveSkip the cost confirmation prompt (useful for CI)
--dry-runShow what would be translated without making API calls
--model <model>Translation model to use(default: pronto-v2)

Exit Codes

0Success — all strings translated
1Authentication error — run pronto login
2Insufficient words remaining on plan
3Aborted by user at cost confirmation

Example

$ pronto translate --target es,ja --auto-approve

pronto status

Show the translation status of your project: how many strings are translated, stale, or missing for each target locale.

$ pronto status [options]

Flags

--locale <lang>Show status for a single locale only
--jsonOutput machine-readable JSON

Exit Codes

0All locales up to date
1Stale or missing translations exist

Example

$ pronto status --locale ja

pronto whoami

Print the currently authenticated account and plan details.

$ pronto whoami

Exit Codes

0Authenticated
1Not authenticated — run pronto login

Example

$ pronto whoami
you@example.com · Studio plan · 62,400 / 150,000 words used

pronto login

Authenticate with your Pronto account. Opens a browser window for OAuth. The token is stored in ~/.pronto/credentials.

$ pronto login [options]

Flags

--token <token>Authenticate with a pre-generated API token (for CI environments)

Exit Codes

0Authentication successful
1Authentication failed or cancelled

Example

$ pronto login --token $PRONTO_TOKEN

pronto logout

Remove stored credentials from the local machine.

$ pronto logout

Exit Codes

0Credentials removed

Example

$ pronto logout