v0.11.0 · Open Source · BSL 1.1

Your AI Coding
Command Center

Run multiple Claude Code sessions with built-in intelligence.
Web research. Code graph. Telegram. Desktop app.
Free forever. Upgrade from $39/yr.

6+ Concurrent Sessions
7 Auto-Injection Points
67% Token Savings
100+ Library Auto-Detect
Why Companion

Claude Code is powerful.
Companion adds orchestration on top.

Stop juggling terminals. Stop losing context. One command center for all your AI coding.

Without Companion

  • One terminal per session
  • No overview of all sessions
  • Can't monitor from phone
  • Manual session management
  • Context lost between sessions
  • Agent wastes 30-50 tool calls searching
  • No permission auto-approval

With Companion

  • All sessions in one grid
  • Real-time activity terminal
  • Telegram bot for mobile
  • Auto session lifecycle + smart compact
  • Shared context via Magic Ring
  • CodeGraph catches missed deps before regressions
  • Cost budget enforcement per session
Features

Everything you need to
orchestrate AI coding.

Multi-Session Grid

Run 6+ Claude Code sessions simultaneously. Each gets its own terminal, status indicator, and quick controls. Expand any session for full interaction.

Magic Ring

Siri-style glowing orb for session health at a glance. Link sessions, share context, trigger debates between agents.

Telegram Bot

22 commands. Start sessions, approve permissions, upload files, run research — all from your phone. Bidirectional sync with web UI.

Activity Terminal

Live event stream from all sessions — tool calls, thinking, errors, costs — in one scrollable feed. Filter by session or type.

Debate Mode

Pit multiple Claude sessions against each other. Structured rounds, counterarguments, and a final verdict. Let AI argue so you don't have to.

Desktop App

Native app for Windows, macOS, and Linux. System tray, auto-updater, and offline-capable. Built with Tauri.

Permission Gate

Claude asks to run a command? Approve or deny from web UI or Telegram. Color-coded danger flags keep you in control.

Smart Sessions

Auto-compact (3 modes), cost budget caps, session rename, enhanced resume with search. Context meter shows remaining window.

Docker Ready

One docker compose up and you're running. Server, web UI, and Telegram bot — all in a single container.

Intelligence Layer

Your agents just got
a lot smarter.

Companion doesn't just manage sessions — it auto-injects code structure into every message. Agents skip the searching and start solving.

4+L0-L3 Context layers auto-loaded
~5 Search calls saved per message
74K → 20K Session context shrunk by Wiki

CodeGraph

Semantic Code Intelligence
  • 4 Auto-Injection Points Project map at session start (~1,500 tokens). Related symbols per message (~800 tokens). Plan review catches missed deps. Break check warns before regressions.
  • 5 Languages, 15 Symbol Types TypeScript, Python, Rust, Go, Java. Functions, classes, interfaces, hooks, endpoints — all with trust-weighted edges and signatures.
  • Prevents Regressions, Not Just Maps Code When your agent plans file changes, CodeGraph flags unmentioned dependencies. When files are modified, it warns which imports may break. Saves ~5 search calls per message.
CodeGraph Ready CODEBASE 906 nodes 745 edges 170 files 2.4s scan HOT FILES ws-bridge.ts 42 session-mgr.ts 33 cli-launcher.ts 25 license.ts 17

Wiki KB

Living Docs for Agents
  • 4-Layer Lazy Loading (L0 → L3) L0 index always injected (~500 tokens). L1 rules when hot. L2 patterns on demand. L3 examples only when the agent asks. Full 74K knowledge base, 20K in-context.
  • Cross-Adapter — Claude, Codex, Gemini, OpenCode One wiki feeds every CLI. Tool name rotates per adapter (companion_wiki_note for Claude, MCP for the rest) so agents record discoveries as they work.
  • Raw → Polished Pipeline Agents dump raw notes; a background LLM pass deduplicates, tags, and promotes them to structured articles. Your team's learnings compound.
Wiki — companion 142 articles LAYERS L0 _index · always injected 500 tok L1 rules · invariants · conventions 3K tok L2 patterns · recipes · on demand 9K tok L3 examples · agent-requested 61K tok → agents pull down the layers they need, never the whole wiki
Pricing

Simple, honest pricing.
Pay yearly, cancel anytime.

No hidden fees. Free tier is forever. Paid plans unlock more sessions and premium intelligence features.

You bring your own Claude subscription. Companion is the management layer — we don't touch your API usage or billing.

Free

$0 forever

No account required

  • 2 concurrent sessions
  • Web dashboard + Magic Ring
  • 1 Telegram bot
  • Templates + free model debate
  • Desktop app (macOS/Win/Linux)
  • MCP auto-detect
  • 14-day Pro trial included
Download Free
Secure checkout via Polar.sh 30-day money-back guarantee macOS · Windows · Linux
Get Started

Deploy in seconds.

Companion runs locally on your machine via Docker or desktop app. It spawns Claude Code CLI processes using your own Claude subscription. Your code never leaves your computer.

bash
# 1. One-line install (downloads docker-compose.yml + .env)
curl -fsSL https://companion.theio.vn/install | sh
cd companion

# 2. Launch — free tier starts instantly
docker compose up -d

# ✓ Open http://localhost:3580
# ✓ 2 sessions free, forever
# ✓ Uses your own Claude Code subscription

Requires Docker Desktop + your own Claude subscription. Image pulled from ghcr.io.

powershell
# 1. One-line install (PowerShell)
irm https://companion.theio.vn/install.ps1 | iex
cd companion

# 2. Launch — free tier starts instantly
docker compose up -d

# ✓ Open http://localhost:3580
# ✓ 2 sessions free, forever
# ✓ Uses your own Claude Code subscription

Requires Docker Desktop for Windows + your own Claude subscription.

Native desktop app — no Docker required. Built-in server and auto-updater.

v0.11.0 · Requires your own Claude subscription.

1 Open Settings in Companion web UI
2 Paste your license key in the License section
3 Click Activate — Pro unlocks instantly, no restart needed

License key emailed after payment. You can also set COMPANION_LICENSE in your .env file.

FAQ

Frequently asked questions.

Do I need my own Claude subscription?

Yes. Companion uses your existing Claude Code subscription (Max or your own API key). We don't provide API access or charge for Claude usage — you pay Anthropic directly. Companion is purely the management layer on top.

What does Companion actually do?

Companion spawns and manages Claude Code CLI sessions on your machine. It gives you a web dashboard to run multiple sessions at once, automatic web research and code intelligence, a Telegram bot to chat with Claude from your phone, real-time activity monitoring, and shared context across sessions via the Magic Ring. Think of it as a command center for Claude Code.

How does the yearly subscription work?

Pro is $5/month or $39/year (save 35%). Your license key works for the subscription period. When it expires, you drop back to the free tier (2 sessions, 1 bot). Renew anytime to re-activate. Cancel anytime — no auto-renewal surprises.

What's included in the free tier?

Free tier gives you 2 concurrent sessions forever with the full web dashboard, Magic Ring, 1 Telegram bot, templates, free model debate, desktop app, and MCP auto-detect. No account, no credit card, no time limit. Plus a 14-day Pro trial to try everything. Upgrade when you need more.

What does Pro unlock?

Pro ($5/mo or $39/yr) unlocks unlimited sessions, multi-bot Telegram, multi-platform debate (Codex, Gemini, OpenCode), CodeGraph (blast radius, flow trace), custom domain with Let's Encrypt SSL, custom personas, and RTK Pro compression. Free tier gives you 2 sessions and 1 bot — enough to try everything.

What is CodeGraph?

CodeGraph scans your codebase across 5 languages (TypeScript, Python, Rust, Go, Java), builds a trust-weighted dependency graph, and auto-injects at 4 points: project map at session start, related symbols per message, plan review (catches missed dependencies), and break check (warns before regressions). Saves ~5 search calls per message and cuts agent context-gathering time by 40-60%.

Why does it run locally?

Companion runs locally on your machine via Docker or desktop app — it spawns Claude Code processes that need direct filesystem access. The app runs on localhost:3580. The only external call is license verification via pay.theio.vn. Your code and credentials never leave your machine.

How does the Telegram bot work?

Create a Telegram bot via BotFather, add the token to your .env. Available on all tiers (including free) with 22 commands: start sessions, send messages, approve permissions, upload files, and get real-time notifications. Stream Bridge lets you seamlessly switch between web and Telegram mid-conversation.

What are the system requirements?

Docker Desktop (recommended) or the native desktop app. Works on macOS, Linux, and Windows (WSL). Minimum 2GB RAM. You'll also need an active Claude Code subscription from Anthropic.

Is there a money-back guarantee?

Yes. All paid licenses come with a 30-day money-back guarantee. If Companion isn't right for you, email us and we'll refund your purchase — no questions asked.

Ready to level up your
Claude Code workflow?

Join developers who ship faster with Companion.

Download Free Docker or Desktop · No account needed · 2 sessions forever