Skip to main content
sovara is the terminal interface for Sovara. It complements the Python and TypeScript SDKs: instrumented code creates runs, while the CLI helps people and coding assistants inspect and improve them. Most commands output JSON so assistants can parse the result reliably.
  1. Install the CLI, then use an existing Sovara environment or choose a local, remote, or headless setup in Installation.
  2. Add an SDK run with an explicit project name in code. For guided setup, run sovara setup from the agent repository.
  3. Run the application normally, or use sovara record -- <command> when you want terminal run metadata.
  4. Inspect the run with sovara probe and sovara logs.
  5. Rerun an LLM step, annotate examples, manage lessons, or track project issues when the trace shows a concrete follow-up.
  6. Run sovara onboard for benchmark-grounded, human-reviewed onboarding.
The CLI does not infer a project from the current directory. SDK code owns project selection; project-scoped CLI commands require an explicit project selector.

​
For coding assistants

From the repository that contains the agent, run:
The command installs the Sovara skill for an available coding assistant and launches that assistant in the current directory. If both Codex and Claude Code are installed, it asks which one to use. For manual or advanced skill installation, use sovara install-skill. After the repository is instrumented, launch guided onboarding from that repository or pass it explicitly:
Onboarding verifies the configured environment and traces, establishes trusted ground truth with the human, and checks benchmark samples against it.