> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovara-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Use the Sovara CLI to set up, report, inspect, rerun, annotate, and improve agent runs.

`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.

## Recommended path

1. Install the CLI, then use an existing Sovara environment or choose a local,
   remote, or headless setup in [Installation](/get-started/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, or manage lessons when the trace
   shows a concrete follow-up.

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:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
cd agent-dir
sovara setup
```

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`.

## What to read next

* [Install the CLI](/cli/install)
* [Record and report runs](/cli/record)
* [Inspect runs](/cli/inspect)
* [Rerun LLM steps](/cli/rerun-steps)
* [Install the assistant skill](/cli/assistant-skill)