- name
- translate-cli
- description
- End-user guide for running and configuring the
translateCLI 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.
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
translatecommands 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 configandconfig.toml. - Customize prompts with presets, inline templates,
@filetemplates, and placeholders. - Explain output behavior (
stdout,--output,--in-place, suffix naming), parallel jobs, dry-run, and validation errors. - Streaming output:
--streamforces on,--no-streamforces off, otherwisedefaults.streamapplies.
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 anthropicNote: 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