Skip to main content
Install the Sovara CLI first so you can check whether an existing Sovara environment is already available. Then choose a local, remote, or headless setup and install the SDK for your agent’s language.

​
Sovara CLI

Sovara’s CLI gives you terminal access to run inspection, trace queries, logs, and shared skill guidance. The Python SDK and TypeScript SDK do not install the sovara command.
Open a new terminal window if sovara is not found immediately, then verify the installation:
Install the Sovara skill for Codex and Claude Code:

​
Connect to Sovara

The desktop app starts with its fixed Local app-server connection. To add a remote app-server connection, open Settings > App-server connection settings and enter the origin provided by your administrator. New remote deployments must set SOVARA_ORG_ID to the Sovara organization ID provided for that deployment. Desktop shows the organization name next to each connection as soon as the server can resolve it, or its organization ID as a fallback. Choose any remembered app-server connection from the selector on the Projects page; remote connections prompt you to sign in. CLI app commands automatically follow the active app-server connection:
  • If sovara status succeeds, the CLI is using the desktop’s active app-server connection and, when it is remote, its signed-in session.
  • To change environments, choose another app-server connection from the selector on the Projects page. CLI app commands do not have separate app-server configuration.
  • For a headless or CI agent host, configure the execution-server URL and agent token through the Python API reference or TypeScript API reference. Headless agent configuration is for recording and runtime traffic; user-facing CLI app commands use the desktop app-server connection.

​
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.
Latest installers
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, leave Local selected, and verify the connection:
Keep the desktop app running while using the local workspace. Switching the desktop app-server connection changes the app server used by the UI and CLI app commands; it does not change an SDK’s execution-server URL or agent token.

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