Skip to content

README.md

Latest commit

 

History

History
128 lines (98 loc) · 4.13 KB

README.md

File metadata and controls

128 lines (98 loc) · 4.13 KB
Raw

Codbash

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

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

0403.mp4

npm Node License Zero deps

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
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 messages
  • 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 on all agent types
  • 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 (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 and Codex
  • Handoff: generate context document to continue in any agent
  • Install Agents: one-click install commands for all agents

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
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
~/.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
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