Caspian CLI - one terminal copilot over Claude Code, Codex and Gemini

Runs on top of AI agents you already have.

Claude Code, Codex, Gemini, Cursor and Devin. Caspian runs them in the background and shows their answers in one session.

~/code/my-app

$ caspian agents ● Claude Code (default) 2.4.1 (Claude Code) fast: Haiku 4.5 · balanced: Sonnet 5.5 · capable: Opus 5.5 /usr/local/bin/claude ● OpenAI Codex CLI codex-cli 0.98.0 fast: GPT-6 Luna · balanced: GPT-6.1 Sol · capable: GPT-6 Astra /usr/local/bin/codex ● Gemini CLI 0.31.0 fast: Gemini Flash-Lite · balanced: Gemini Flash · capable: Gemini Pro /usr/local/bin/gemini ○ Cursor CLI — not installed. Install from cursor.com/cli ○ Devin CLI — not installed. Install from docs.devin.ai/cli

Picks the right model for each command.

Quick questions go to the cheapest model, hard changes to the strongest. Subscriptions before API keys. /use codex pins a tool.

caspian

Runs a pre-flight check before big changes.

Turns, tokens and time, next to the fast model. Dollars only when you're billed per token.

caspian

Pre-flight — 7 files, ~420 lines changed (triage guess) this run OpenAI Codex CLI · GPT-6 Astra subscription ~20 turns · ~576K in / ~7K out · ~4 min fast Claude Code · Haiku 4.5 subscription ~20 turns · ~576K in / ~7K out · ~2 min Subscriptions have no per-request charge; API keys are billed at list prices, before prompt caching.

Refines your vague prompts.

A cheap model fixes typos and turns "it" into what you meant. You choose what gets sent.

caspian

❯ where is the login page? → Claude Code · Haiku 4.5 (fast · question · cheapest on your subscriptions) ⎿ Grep login It's in src/pages/login.tsx. ✓ 5s · no files changed ❯ add a forgot pasword link to it → Claude Code · Sonnet 5.5 (balanced · change, ~20 lines) Refined: Add a "Forgot password?" link to the login page in src/pages/login.tsx.

One memory for every tool

.caspian/context.md carries decisions and changes across tools and sessions.

Safe by default

Questions are read-only. Shell commands stay off until you press Shift+Tab.

Usage at a glance

The header shows how much of each tool's plan limits you've used.

Free

Runs on your tools' own plans. Caspian Pro skips triage for clear, small requests.

Have at least one AI coding CLI, signed in

Claude CodeOpenAI Codex CLIGemini CLICursor CLIDevin CLI

Install with npm

Node.js 20.18+. The desktop app already includes it.

npm install -g @caspianmd/caspian

Run it in your project

cd my-project && caspian

Questions

Which AI tools does it work with?

Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor CLI and Devin CLI. caspian agents shows which ones it found.

What does it cost?

Nothing. Requests run on, and count against, the tools' own plans.

How does Autopilot choose a tool?

Among tools that are signed in, subscriptions come before API keys. Fast requests get the cheapest model, capable ones the strongest, balanced ones stay on your current tool. /use <tool> pins a tool; /use auto undoes it.

Will it change my code without asking?

Questions never change files. Changes edit files directly and list what they touched. Big changes ask first.

What leaves my machine?

Your request goes to the tool's own AI provider, as if you ran it yourself. With Caspian Pro, the request text also goes to Caspian's decision service.