CLI commands

Full command reference for the Optamus CLI.

optamus run

Start an agent run.

optamus run [prompt] [flags]
FlagTypeDescription
--workspace <path>stringWorkspace directory
--model <id>stringModel override
--jsonbooleanStructured output
--yesbooleanSkip permission prompts
--stdinbooleanRead prompt from stdin
--max-tokens <n>numberPer-run token budget
--parallel <n>numberFan out across matches

optamus init

Create workspace config in the current directory.

optamus doctor

Check credentials, workspace access, and surface versions.

optamus keys

Manage API keys: create, list, revoke.

optamus --version

Print the CLI version.