translate-cli
Use this skill to help end users run and configure the translate CLI.
translate is a command-line translator for text, stdin, files, globs, and .xcstrings catalogs. It supports multiple providers (OpenAI, Anthropic, Ollama, OpenAI-compatible endpoints, Apple providers, DeepL), prompt presets and template overrides, and persistent TOML configuration.
Capabilities
- Build correct
translate commands for inline text, stdin, single-file, and multi-file workflows.
- Keep options before positional input(s) when constructing commands (for example,
translate --to de README.md).
- Explain provider selection, credentials, model/base URL requirements, and provider-specific constraints.
- Configure defaults, provider endpoints, network settings, and presets with
translate config and config.toml.
- Customize prompts with presets, inline templates,
@file templates, and placeholders.
- Explain output behavior (
stdout, --output, --in-place, suffix naming), parallel jobs, dry-run, and validation errors.
- Streaming output:
--stream forces on, --no-stream forces off, otherwise defaults.stream applies.
Starter commands
translate --text --to fr "Hello world"
translate --to de README.md
translate --provider ollama --text --to en --dry-run "Merhaba dunya"
translate config set defaults.provider anthropic
Note: prefer option-before-input ordering in all examples and generated commands.
References
- Quick examples:
references/quickstart.md
- Full flag and subcommand reference:
references/flags-and-subcommands.md
- TOML schema and precedence:
references/config-toml.md
- Provider rules and environment variables:
references/providers-and-env.md
- Presets, prompt templates, placeholders:
references/presets-and-prompts.md
- Runtime behavior, warnings, and exit codes:
references/behavior-and-errors.md
1---2name: translate-cli3description: End-user guide for running and configuring the `translate` CLI across text/stdin/file/glob inputs, provider selection, presets, custom prompt templates, and TOML settings. Use when users ask for command construction, config updates (`translate config`/`translate presets`), provider setup, dry-run validation, or troubleshooting translation behavior.4---56# translate-cli78Use this skill to help end users run and configure the `translate` CLI.910`translate` is a command-line translator for text, stdin, files, globs, and `.xcstrings` catalogs. It supports multiple providers (OpenAI, Anthropic, Ollama, OpenAI-compatible endpoints, Apple providers, DeepL), prompt presets and template overrides, and persistent TOML configuration.1112## Capabilities1314- Build correct `translate` commands for inline text, stdin, single-file, and multi-file workflows.15- Keep options before positional input(s) when constructing commands (for example, `translate --to de README.md`).16- Explain provider selection, credentials, model/base URL requirements, and provider-specific constraints.17- Configure defaults, provider endpoints, network settings, and presets with `translate config` and `config.toml`.18- Customize prompts with presets, inline templates, `@file` templates, and placeholders.19- Explain output behavior (`stdout`, `--output`, `--in-place`, suffix naming), parallel jobs, dry-run, and validation errors.20- Streaming output: `--stream` forces on, `--no-stream` forces off, otherwise `defaults.stream` applies.2122## Starter commands2324```bash25translate --text --to fr "Hello world"26translate --to de README.md27translate --provider ollama --text --to en --dry-run "Merhaba dunya"28translate config set defaults.provider anthropic29```3031Note: prefer option-before-input ordering in all examples and generated commands.3233## References3435- Quick examples: `references/quickstart.md`36- Full flag and subcommand reference: `references/flags-and-subcommands.md`37- TOML schema and precedence: `references/config-toml.md`38- Provider rules and environment variables: `references/providers-and-env.md`39- Presets, prompt templates, placeholders: `references/presets-and-prompts.md`40- Runtime behavior, warnings, and exit codes: `references/behavior-and-errors.md`
dvcrn