rototo
API

rototo CLI reference

Global Flags

Workspace Commands

When workspace is omitted, rototo walks up from the current directory until it finds rototo-workspace.toml. The positional workspace argument is kept for compatibility; --workspace is preferred for consistency with qualifier, variable, and diagnostics commands. Workspace inputs can be local paths, file:// URIs, git+file://, git+https://, git+ssh://, or https:// archive URLs. Plain http:// sources are rejected. Git sources support #ref:subdir; archive URLs support #:subdir.

Qualifier Commands

Variable Commands

Resolution commands accept repeatable --context inputs. Each value can be a JSON object, @path/to/context.json, or path=value; later inputs override earlier ones. Qualifiers are resolved against that context. Variables resolve by environment, applying matching rules before the environment's fallback value.

Examples

rototo variable resolve llm-agent-config --workspace ./workspace --env prod \
  --context '{"user":{"tier":"premium"}}'

rototo variable resolve-all --workspace ./workspace --env prod \
  --context @context.json

rototo qualifier resolve enterprise-accounts --workspace ./workspace \
  --context account.plan=enterprise --context account.seats=250

rototo workspace lint \
  --workspace git+https://github.com/acme/config.git#main:rototo

ROTOTO_WORKSPACE_TOKEN=secret rototo workspace inspect \
  --workspace https://example.com/rototo-workspace.tar.gz#:workspace

Documentation Commands

The CLI bundles documentation as Markdown. HTML export and local serving are left to the public documentation site toolchain.

Terminal Color

Human-readable CLI output uses rototo terminal colors when stdout or stderr is a terminal. Machine-readable --json output is never styled. Set NO_COLOR to disable color. Set CLICOLOR_FORCE=1 to force color in a non-terminal.

Diagnostic Commands

Diagnostics are global by default. --workspace is optional and only scopes the catalog subject today.

Shell Completions

Exit Policy