CLI reference

The unified soju console entry lives under src/soju/cli/ and installs with uv sync. Run from the repo root unless noted. Option lists are generated from the live Typer apps (sphinxcontrib-typer).

uv run soju --help
uv run soju <subcommand> --help

Validate after any data change: uv run poe validate or uv run poe container-cli validate-schemas (and align / registry) in the backend image; full suite: docker compose run --rm --no-deps backend poe validate

• soju (unified entry) (unified entry — all subcommands)

• soju import

• soju promote

• soju levels

• soju validate-schemas

• soju align

• soju registry

• soju translate-words

• soju fill-examples

• soju fill-verbs

• soju embed-index

• soju backend

See Poe tasks (shortcuts) for shortcut tasks and Docker for Compose services that wrap these tools.