Orchestrivo for terminal

orchestrivo is the command line for Orchestrivo. Sign in once, then drive your agents, sessions, chat completions, MCP integrations, Company Brain, skills, and artifacts from the terminal. Every command has a --json mode so you can pipe results into scripts, cron jobs, or any other tool you already use.

Install

curl -fsSL https://orchestrivo.com/cli/install.sh | sh

Or paste this prompt into your coding agent and it sets everything up for you

The prompt is self-contained: the agent installs the CLI, sorts out authentication with you, and installs the Orchestrivo CLI skill on its own.

# Set up the Orchestrivo CLI

Set up the Orchestrivo CLI in this environment so you can operate Orchestrivo (run agents,
call MCP integration tools, search Company Brain). Follow these steps in order.

## Step 1: Install the CLI

Skip this step if `orchestrivo --version` already works. Otherwise install it
(macOS, Linux, or WSL only — it does not run on native Windows):

```bash
curl -fsSL https://orchestrivo.com/cli/install.sh | sh
```

On an interactive machine the installer ends by offering `orchestrivo login` — tell me
to accept it. On a headless machine or CI, ask me for a Orchestrivo API key and my
user ID. Both are on https://www.orchestrivo.com/settings/profile/general, in the
"Orchestrivo API key" and "User ID" rows. Export them as `ORCHESTRIVO_API_KEY` and
`ORCHESTRIVO_USER_ID`. Never print or log the API key.

## Step 2: Verify authentication

```bash
orchestrivo agents list
```

If this fails with an authentication error, fix the credentials from Step 1
before continuing.

## Step 3: Install the Orchestrivo CLI skill

```bash
orchestrivo plugin install orchestrivo
```

This installs a `orchestrivo-cli` skill with the full command reference into your
skill directories. Read it before using unfamiliar commands.

## Step 4: Learn the surface

- List what is available: `orchestrivo agents list`, `orchestrivo mcp list`.
- Always pass `--json` when you parse output.
- Use `orchestrivo <command> --help` before using a command; do not invent flags.
- Discover MCP tools with `orchestrivo mcp tools <server> --json` instead of guessing
  tool names.

When all steps pass, tell me what agents and MCP servers you found and ask what
I want to run first.

The installer is fully self-contained under ~/.orchestrivo: it ships its own Python, never touches your system Python, and needs no sudo. Verify the install:

orchestrivo --version

Update any time with:

orchestrivo update

Using Orchestrivo as a library instead? See the Python SDK.

Windows isn’t supported. The Orchestrivo CLI runs on macOS and Linux only. This applies to every command, including orchestrivo login and syncing skills or artifacts, because credential storage and the OAuth callback server rely on POSIX-only paths.Windows users have two options:

Use WSL (Windows Subsystem for Linux) and install the CLI inside your Linux distribution. This is the recommended path.
Use the Python SDK instead. It works natively on Windows. Import from orchestrivo import Orchestrivo directly. See the Python SDK reference.

Linux prerequisites

The CLI stores credentials in your OS keychain. macOS Keychain is always available, but on Linux you need one of:

sudo apt install gnome-keyring libsecret-1-0
sudo apt install kwalletmanager

On a headless box without a keychain, skip orchestrivo login entirely and pass credentials per invocation via environment variables.

orchestrivo login

Pick OAuth (browser) at the prompt. The CLI opens your browser, you click “Allow” on the Orchestrivo consent screen, and you’re signed in. The CLI stores tokens in your OS keychain and refreshes them for you when they expire. Prefer an API key, or running on a headless box? See Authentication.

Your first command

List the agents you can see:

orchestrivo agents list

ID                NAME                MODEL                       TEAM            ACTIVE
agent_g6f1a2b3    Sales research      anthropic/claude-sonnet-4   team_4f8c92ab   yes
agent_h7e9c1d4    Support triage      openai/gpt-5                team_4f8c92ab   yes

Grab an ID from that table and start a chat:

orchestrivo sessions create agent_g6f1a2b3 --input "Summarize this week's pipeline."

That’s it. From here, every command works the same way: orchestrivo <thing> <action>, with --help on anything to see all the flags.

Use with coding agents

Now that you’re set up, your coding agent, such as Claude Code, Cursor, or Codex, can drive Orchestrivo for you. One command installs the orchestrivo-cli skill, covering setup, every command, and the sharp edges, into each coding agent detected on your machine:

orchestrivo plugin install orchestrivo

Restart your agent (or start a new session) and it picks the skill up whenever a task involves Orchestrivo. Haven’t installed the CLI yet? The setup prompt in Install has your agent do all of this for you.

The skill ships inside the CLI as an Agent Plugin. To write the raw plugin package (plugin.json + skills/) somewhere explicit, such as a plugin-aware client or a project checkout, use orchestrivo plugin install orchestrivo --dir <path>.

Commands

Command	What it does
`orchestrivo login` / `logout`	Manage stored credentials
`orchestrivo agents`	List, inspect, create, and update agents, and export agent versions
`orchestrivo sessions`	Create, inspect, send messages to, and cancel agent sessions
`orchestrivo evaluations`	Create organization evaluations, choose which agents they grade, and run them over past sessions
`orchestrivo chat`	Send chat completions to any supported model (unary, streaming, structured, image)
`orchestrivo decisions`	Ask decision models structured questions and get answers with probabilities
`orchestrivo mcp`	Explore connected MCP servers and execute their tools
`orchestrivo brain`	Search your Company Brain’s indexed knowledge sources
`orchestrivo skills`	List, upload, update, and download skill files
`orchestrivo artifacts`	List and download artifacts produced by agents

Global flags

These work on every command:

Flag	Env var	Description
`--team-id`	`ORCHESTRIVO_TEAM_ID`	Scope the command to a single team.
`--base-url`	`ORCHESTRIVO_BASE_URL`	Override the Orchestrivo API base URL (useful for self-hosted/staging).
`--version`, `-V`	—	Print the CLI version and exit.
`--help`, `-h`	—	Show contextual help for any command or subcommand.

Most subcommands additionally accept --json to print the raw response payload instead of the human-friendly table, which is handy for piping into jq, scripts, or other tools.

​Install

​Linux prerequisites

​Sign in

​Your first command

​Use with coding agents

​Commands

​Global flags

Install

Linux prerequisites

Sign in

Your first command

Use with coding agents

Commands

Global flags