Cockpit 🚀

The statusline for Claude Code that actually helps you manage context.

Why Cockpit?

Every other statusline shows you numbers. Cockpit shows you what to do.

Feature	ccline	Others	Cockpit
Context usage	✅	✅	✅
Progress bars	❌	❌	✅
Burn rate (tokens/min)	❌	❌	✅
ETA to context limit	❌	❌	✅
Visual themes	Basic	❌	✅ 5 themes
Task integration	❌	❌	✅
MCP server count	❌	❌	✅
Cache hit rate	❌	❌	✅
Beginner glossary	❌	❌	✅

The killer feature: Cockpit tells you when to prepare for handoff based on your actual burn rate, not just a percentage.

Opus 4.5 │ ctx:[████░░░░] 45% (90k) │ burn:2.1k/m │ eta:23m │ cost:$1.25 │ git:main *3 │ tasks:2

Quick Install

# Clone and build
git clone https://github.com/bacharyehya/cockpit.git
cd cockpit
bun install
bun run build

# Install both tools
cp dist/cockpit ~/.claude/bin/
cp dist/cockpit-grid ~/.claude/bin/

Then add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/bin/cockpit"
  }
}

Themes

Cockpit supports multiple visual themes:

Theme	Look	Best For
bars	[████░░░░] 45%	Visual learners
blocks	▓▓▓▓░░░░ 45%	Compact display
cylinder	⛁⛁⛁⛶⛶⛶ 45%	Like /context
minimal	45%	Minimalists
emoji	🟢 45%	Quick glance
powerline	Fancy separators	Nerd Font users

Change theme: cockpit theme cylinder

Cockpit Grid - Full Visualization

Love the /context visualization? Run it continuously in a separate terminal:

# Watch mode - auto-updates every 2 seconds
cockpit-grid

# Or in tmux
tmux split-window -h 'cockpit-grid'

⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛀   48k/200k tokens (24%)
⛀ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁
⛁ ⛁ ⛁ ⛁ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   Estimated usage by category
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System prompt: 2.8k
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System tools: 17.1k
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ Memory files: 6.9k
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛝ ⛝ ⛝   ⛁ Messages: 17.9k
⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝   ⛶ Free space: 108k
⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝   ⛝ Autocompact buffer: 45k

Segments

Segment	Example	What it means
Model	Opus 4.5	Current Claude model
ctx	[████░░] 45% (90k)	Context usage with progress bar
burn	2.1k/m	Tokens consumed per minute
eta	23m	Time until context limit
cost	$1.25	Session cost so far
time	7m	Session duration
git	main *3	Branch + uncommitted changes
tasks	2	Active tasks from ~/tasks/active/
project	cockpit	Current project name
mcp	5	MCP servers configured
cache	85%	Cache hit rate (efficiency)

Color Coding

• 🟢 Green: All good, plenty of room
• 🟡 Yellow: Getting there, stay aware
• 🔴 Red: Action needed soon

Slash Commands

If you're using Cockpit as a plugin:

• /cockpit:help - Show help with beginner glossary
• /cockpit:theme <name> - Change visual theme

Glossary (for Beginners)

Context Window - Claude's memory. ~200k tokens. When full, older content gets summarized.

Burn Rate - How fast you're using context. High = lots of tool calls. Low = conversation.

ETA - When context will fill up at current pace. Yellow = wrap up. Red = save now!

Cache - Reusing previous work. Higher % = more efficient = cheaper.

MCP - External tools Claude can use (Airtable, Gmail, Slack).

Configuration

Config file: ~/.cockpit/config.json

{
  "theme": "bars",
  "showLabels": true,
  "segments": {
    "model": true,
    "context": true,
    "burn": true,
    "eta": true,
    "cost": true,
    "time": true,
    "git": true,
    "tasks": true,
    "project": true,
    "mcp": false,
    "cache": false
  }
}

Philosophy

"The statusline should tell you what to do, not just what is."

Most statuslines are dashboards of numbers. Cockpit is a copilot - it watches your context consumption and alerts you when action is needed.

Building from Source

Requires Bun:

git clone https://github.com/bacharyehya/cockpit.git
cd cockpit
bun install
bun run build
./dist/cockpit --help

License

MIT

---

Built with 🧡 by Bash & Claude