Skip to content

CLI

This page lists every command of babelfishers with its options. It is generated from the commands themselves. You can see the same information in your terminal with babelfishers --help and babelfishers <command> --help.

babelfishers

Babel Fishers command line interface.

Usage:

babelfishers [OPTIONS] COMMAND [ARGS]...

Options:

  --version  Show the version and exit.
  --help     Show this message and exit.

babelfishers ci

Translate the project files on a CI runner and write the changes back through a pull request.

Usage:

babelfishers ci [OPTIONS] {gitlab|github}

Options:

  --pull-request             Open a new pull request from a bot branch instead
                             of updating the current one.
  --pull-request-title TEXT  Title of a new pull request. Defaults to the
                             commit message.
  --pull-request-body TEXT   Description of a new pull request.
  --commit-message TEXT      Message of the commit that holds the
                             translations.
  --help                     Show this message and exit.

babelfishers init

Initialize a new Babel Fishers project.

Usage:

babelfishers init [OPTIONS]

Options:

  --source LOCALE                 Source locale code.
  --targets LOCALES               Comma-separated target locale codes.
  --engine [deepl|azure|anthropic|openai|mistral|google|deepseek|google-translate|libre-translate]
                                  Default translation engine.
  -y, --yes                       Skip every confirmation, including the
                                  overwrite one.
  --force                         Overwrite an existing project without
                                  asking.
  --help                          Show this message and exit.

babelfishers locales

List the supported locale codes.

Usage:

babelfishers locales [OPTIONS]

Options:

  -s, --search TEXT  Only show locales whose code or name contains this text.
  --help             Show this message and exit.

babelfishers memory

Inspect and maintain the translation memory.

Usage:

babelfishers memory [OPTIONS] COMMAND [ARGS]...

Options:

  --help  Show this message and exit.

babelfishers memory clear

Remove every entry from the translation memory.

Usage:

babelfishers memory clear [OPTIONS]

Options:

  -y, --yes  Skip the confirmation prompt.
  --help     Show this message and exit.

babelfishers memory prune

Remove entries from the translation memory. Pick one filter.

Usage:

babelfishers memory prune [OPTIONS]

Options:

  --older-than INTEGER RANGE      Remove entries not used in this many days.
                                  [x>=0]
  --engine [deepl|azure|anthropic|openai|mistral|google|deepseek|google-translate|libre-translate]
                                  Remove entries made by this engine.
  --keep INTEGER RANGE            Keep only this many of the most recently
                                  used entries.  [x>=0]
  --help                          Show this message and exit.

babelfishers memory stats

Show what the translation memory holds.

Usage:

babelfishers memory stats [OPTIONS]

Options:

  --help  Show this message and exit.

babelfishers run_lock

Inspect and maintain the record of the last completed run.

Usage:

babelfishers run_lock [OPTIONS] COMMAND [ARGS]...

Options:

  --help  Show this message and exit.

babelfishers run_lock prune

Delete the run lock file.

Usage:

babelfishers run_lock prune [OPTIONS]

Options:

  --help  Show this message and exit.

babelfishers run_lock refresh

Rebuild the run lock from the config, the sources and the target files on disk.

Usage:

babelfishers run_lock refresh [OPTIONS]

Options:

  --help  Show this message and exit.

babelfishers translate

Translate the project files.

Usage:

babelfishers translate [OPTIONS]

Options:

  --dry-run  Show what would be translated without making changes.
  --help     Show this message and exit.