Codbash

Control room for AI coding sessions. Search, replay, and resume Claude Code, Codex, Qwen, Pi, Oh My Pi, Cursor, OpenCode, Kiro, Kilo, and Copilot Chat sessions without digging through scattered logs.

Russian / Русский | Chinese / 中文

https://github.com/user-attachments/assets/15c45659-365b-49f8-86a3-9005fa155ca6

Quick Start

npm i -g codbash-app
codbash run

Supported Agents

| Agent | Sessions | Preview | Search | Live Status | Convert | Handoff | Launch | |-------|----------|---------|--------|-------------|---------|---------|--------| | Claude Code | JSONL | Yes | Yes | Yes | Yes | Yes | Terminal / cmux | | Codex CLI | JSONL | Yes | Yes | Yes | Yes | Yes | Terminal | | Pi | JSONL | Yes | Yes | Yes | - | Yes | Terminal | | Oh My Pi | JSONL | Yes | Yes | Yes | - | Yes | Terminal | | Cursor | JSONL | Yes | Yes | Yes | - | Yes | Open in Cursor | | OpenCode | SQLite | Yes | Yes | Yes | - | Yes | Terminal | | Kiro CLI | SQLite | Yes | Yes | Yes | - | Yes | Terminal | | Copilot Chat | JSON/JSONL | Yes | Yes | - | - | Yes | - |

Also detects Claude Code running inside Cursor (via claude-vscode entrypoint).

Features

Browser Dashboard

• Grid and List view with project grouping
• Trigram fuzzy search + full-text deep search across all supported message logs
• Filter by agent, tags, date range
• Star/pin sessions, tag with labels
• GitHub-style SVG activity heatmap with streak stats
• Session Replay with timeline slider and play/pause
• Hover preview + expandable cards
• Themes: Dark, Light, System

Live Monitoring

• LIVE/WAITING badges for terminal-launched agents when their processes can be matched
• Animated border on active session cards
• Running view with CPU, Memory, PID, Uptime
• Focus Terminal / Open in Cursor buttons
• Polling every 5 seconds

Cost Analytics

• Real cost from actual token usage when agents record usage (input, output, cache)
• Per-model pricing: Opus, Sonnet, Haiku, Codex, GPT-5
• Daily cost chart, cost by project, most expensive sessions

Cross-Agent

• Convert sessions between Claude Code, Codex, and Qwen formats
• Handoff: generate context document from any session with readable messages
• Install Agents: one-click install commands for supported agent CLIs

CLI

codbash run [--port=N] [--no-browser]
codbash search <query>
codbash show <session-id>
codbash handoff <id> [target] [--verbosity=full] [--out=file.md]
codbash convert <id> claude|codex|qwen
codbash list [limit]
codbash stats
codbash export [file.tar.gz]
codbash import <file.tar.gz>
codbash update
codbash restart
codbash stop

Keyboard Shortcuts: / search, j/k navigate, Enter open, x star, d delete, s select, g group, r refresh, Esc close

Data Sources

~/.claude/                              Claude Code sessions + PID tracking
~/.codex/                               Codex CLI sessions
~/.cursor/projects/*/agent-transcripts/ Cursor agent sessions
~/.pi/agent/sessions/**/*.jsonl         Pi coding-agent sessions
~/.omp/agent/sessions/**/*.jsonl        Oh My Pi coding-agent sessions
~/.local/share/opencode/opencode.db     OpenCode (SQLite)
~/Library/Application Support/kiro-cli/ Kiro CLI (SQLite)
<vscode-user-data>/workspaceStorage/    Copilot Chat (JSON/JSONL)
  # Linux:   ~/.config/Code
  # macOS:   ~/Library/Application Support/Code
  # Windows: %APPDATA%\Code

Zero dependencies. Everything runs on localhost.

Install Agents

curl -fsSL https://claude.ai/install.sh | bash          # Claude Code
npm i -g @openai/codex                                   # Codex CLI
curl -fsSL https://cli.kiro.dev/install | bash           # Kiro CLI
npm i -g @earendil-works/pi-coding-agent                 # Pi
curl -fsSL https://omp.sh/install | sh                    # Oh My Pi
bun install -g @oh-my-pi/pi-coding-agent                  # Oh My Pi (Bun)
curl -fsSL https://opencode.ai/install | bash            # OpenCode

Requirements

• Node.js >= 18
• At least one AI coding agent installed
• macOS / Linux / Windows

Contributing

main is protected. All changes go through feature branches and pull requests.

git checkout -b fix/my-fix
# make changes
git push -u origin fix/my-fix
gh pr create

• Branch naming: feat/, fix/, chore/, release/
• 1 approval required to merge
• Keep PRs small and focused

See ARCHITECTURE.md for codebase details.

License

MIT