v0.5.1 · 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 makes it intelligent.

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
  • WebIntel auto-injects 100+ library docs
  • CodeGraph catches missed deps before regressions
  • 67% token savings on web content
  • 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 and library docs into every message. Agents skip the searching and start solving.

67% Token savings on web content
7 Auto-injection points
~50 Tool calls saved per session
70% Fewer missed dependencies

WebIntel

Web Research & Docs
  • Auto-Inject Docs — 4,000 tokens/lib Detects 100+ libraries in your messages and auto-injects their latest docs. Saves ~4 tool calls per lookup. 30-min cache, zero redundant fetches.
  • Web Research — 5 sources, 1 command Search, batch-scrape top 5 results, synthesize with citations. Budget: 3,000 tokens. One command: /research.
  • 67% Smaller Context webclaw converts raw HTML to LLM-optimized format — 67% fewer tokens than feeding pages directly. All cached in SQLite with LRU eviction.
WebIntel Online CACHE STATS 94% hit rate 2.4 MB cached 847 hits AUTO-INJECTED drizzle-orm Schema, queries, migrations — 12 pages injected @hono/zod-validator Middleware setup, error handling — 4 pages grammy Bot API, keyboard, sessions — 8 pages injected

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
How It Works

Up and running in
under 3 minutes.

1

Install

Docker (recommended): curl -fsSL companion.theio.vn/install | sh

One command pulls the image and creates your config. Works on macOS, Windows, and Linux.

2

Launch

docker compose up -d

Server, web UI, and Telegram bot start automatically. Free tier is instant — no license needed.

3

Code

# Open browser → localhost:3580 # Click "New Session" # Start coding with Claude

Create sessions, run research, scan your codebase. Free tier is forever — upgrade anytime from $39/yr.

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
  • Telegram bot (full access)
  • Templates + Debate mode
  • Desktop app (macOS/Win/Linux)
  • Thinking mode toggle
  • macOS, Windows, Linux
Download Free

Starter

$39 /year

~$3.25/mo · billed annually

  • Everything in Free
  • 6 concurrent sessions
  • Smart compact + cost budget
  • Stream Bridge (web ↔ Telegram)
  • Priority permission gate
  • 30-day money-back guarantee
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.5.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?

Starter ($39/yr) and Pro ($79/yr) are billed annually. Your license key works for 1 year from purchase. When it expires, you drop back to the free tier (2 sessions, no WebIntel/CodeGraph). Renew anytime to re-activate. No auto-renewal surprises — you renew when you want.

What's included in the free tier?

Free tier gives you 2 concurrent sessions forever with the full web dashboard, Magic Ring, Telegram bot, templates, Debate mode, desktop app, and thinking mode. No account, no credit card, no time limit. Paid plans unlock more sessions and intelligence features (WebIntel, CodeGraph, Scheduled Sessions).

What's the difference between Starter and Pro?

Starter ($39/yr) bumps you to 6 concurrent sessions — great for everyday use. Pro ($79/yr) gives unlimited sessions plus the intelligence layer: WebIntel (auto docs + web research), CodeGraph (code dependency analysis), and Scheduled Sessions (calendar-based automation).

What are WebIntel and CodeGraph?

WebIntel detects 100+ libraries in your messages, auto-scrapes their latest docs via webclaw (67% smaller than raw HTML), and injects them into Claude's context — saving ~4 tool calls per lookup with 30-min caching. It also supports /research (5-source synthesis) and /docs (explicit URL scrape). CodeGraph scans your codebase across 5 languages, 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). Together they save 30-50 tool calls per session and reduce 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