Skip to main content
Claude Code can use the Sovara CLI to inspect runs, query traces, read logs, annotate outcomes, and work with priors from the terminal. This is useful when Claude Code is debugging an agent and needs structured run data instead of copied logs.

​
Guided setup

The fastest way to get started is sovara setup. It installs the Sovara skill and spawns Claude Code with an onboarding prompt that verifies the desktop app, installs the matching SDK for your project, and records a first run: 
sovara setup --target claude
By default the skill is installed globally to ~/.claude/skills/sovara, so it is available in every project. To scope it to one project instead, use --level project: 
sovara setup --target claude --level project --project-dir /path/to/project
If only Claude Code is on your PATH, --target is optional — sovara setup auto-detects it. When both Claude Code and Codex are installed, it prompts you to choose, or you can pass --target claude to skip the prompt. Use --dry-run to print what would happen (resolved binary, skill path, and the kickoff prompt) without spawning anything: 
sovara setup --target claude --dry-run

​
Use Claude Code with Sovara

Install the CLI and make sure the backend is reachable: 
curl -fsSL https://apps.sovara-labs.com/cli/install.sh | sh
sovara status
Then ask Claude Code to:
  • Check whether Sovara is reachable
  • List recent runs
  • Inspect a run graph
  • Read logs for a failed run
  • Queue or annotate an example
  • Inspect or manage priors
  • Record a fresh Python run
You can be explicit: 
How can I use sovara?
For a concrete task, ask: 
Use the Sovara CLI to inspect the latest failed run in this project.
Claude Code will typically start with: 
sovara status
sovara projects
sovara runs --project-id <project-id>
sovara probe <run-id> --only-steps
sovara probe <run-id> --step <step-id>
sovara logs <run-id> --tail 100
To install or refresh project-local skill guidance for Claude Code: 
sovara install-skill --target claude --level project --project-dir /path/to/project