Skip to main content
Start with the Sovara desktop app and CLI. Then install the SDK for the language your agent is written in.

​
Sovara desktop app

The desktop app gives you a local workspace for recording, inspecting, and improving agent runs. Choose the installer for your operating system.
Version 0.4.15
macOS

For Apple Silicon Macs.

Apple Silicon (.dmg)
Windows

For Windows machines.

Windows (.exe)
Linux

For Debian/Ubuntu and Fedora/Red Hat-based distributions.

Debian / Ubuntu Intel/AMD (.deb)Debian / Ubuntu arm64 (.deb)Fedora / Red Hat Intel/AMD (.rpm)Fedora / Red Hat arm64 (.rpm)
After the installer finishes, open Sovara and sign in. Keep the desktop app running while recording runs with the CLI or SDKs.

​
Sovara CLI

Sovara’s CLI is meant to speed up agent development with Codex and Claude Code by giving them terminal access to run inspection, trace queries, logs, and shared skill guidance. The Python SDK and TypeScript SDK do not install the terminal command. Install the Sovara CLI separately when you (or any coding assistant) want to run commands such as sovara record, sovara status, and sovara probe.
Open a new terminal window after installation if sovara is not found immediately. In platform mode, sovara setup and the SDKs use the desktop session instead of asking you to create an agent token. Agent tokens are only needed for headless or CI setups. After the CLI is installed, install the Sovara skill for Codex and Claude Code:

​
Python SDK

Install sovara in the Python environment where your agent runs. Use the same package manager that owns your project environment.

​
TypeScript SDK

Install @sovara/runner in the Node.js project where your agent runs.