You're deep in a coding session with Claude Code. Everything is going great. Then...
- Terminal crashes — hours of context, gone
- Multiple sessions — which one was working on the auth bug?
- Cost anxiety — "How much have I spent today?"
- Lost progress — "What was I doing before lunch?"
Claude Hub monitors all your Claude Code sessions in real-time, automatically recovers crashed sessions, tracks costs, and preserves context across iterations.
npx claude-hubThat's it. Open http://localhost:3377 and take control.
| Without Claude Hub | With Claude Hub | |
|---|---|---|
| Terminal crash | Lose all context, start over | One-click recovery with full context |
| Multiple sessions | Switch terminals, lose track | See all sessions in one dashboard |
| Cost tracking | Check Anthropic console manually | Real-time costs with predictions |
| Session context | Gone when terminal closes | Persisted and searchable |
| Project overview | Scattered across directories | Aggregated by project |
npx claude-hubnpm install -g claude-hub
claude-hub webgit clone https://github.com/majiayu000/claude-hub.git
cd claude-hub
bun install && bun run build
bun run start webIf you see an error like "Claude Hub is damaged and can't be opened" when running the desktop app, this is macOS Gatekeeper blocking unsigned apps — the app is not actually damaged.
Fix it with:
xattr -cr /Applications/Claude\ Hub.appOr if downloaded elsewhere:
xattr -cr ~/Downloads/Claude\ Hub.appThis removes the quarantine attribute that macOS adds to downloaded files.
Monitor all Claude Code instances across your system. See status, current file, last tool, and activity at a glance.
┌─────────────────────────────────────────────────────────────────┐
│ SESSIONS 3 active │
├─────────────────────────────────────────────────────────────────┤
│ ● RUNNING my-app Edit: src/auth.ts 2s ago │
│ ● WAITING api-service Read: README.md 5m ago │
│ ○ IDLE docs Write: guide.md 15m ago │
│ ✗ LOST old-project — 2h ago │
└─────────────────────────────────────────────────────────────────┘
Terminal crashed? Session lost? Recover in seconds with full context preserved.
claude-hub recover <session-id>Three recovery methods:
- Resume — Restore exact session state (recommended)
- Continue — New session in same directory
- New — Fresh start with original prompt
Track spending in real-time. Know exactly where your tokens go.
┌─────────────────────────────────────────────────────────────────┐
│ COST ANALYTICS │
├─────────────────────────────────────────────────────────────────┤
│ Today $12.34 ▲ 23% │
│ This Week $67.89 │
│ This Month $198.50 (Projected: $320) │
│ │
│ Cache Savings $45.20 (38% of total) │
│ Your hit rate: 72% │
└─────────────────────────────────────────────────────────────────┘
Features:
- Per-session cost breakdown
- Cache token tracking (creation 1.25x, read 0.1x)
- Multi-model support (Opus, Sonnet, Haiku)
- Daily/weekly/monthly trends
Claude Hub implements the "relay race" pattern — your progress persists across sessions.
┌─────────────────────────────────────────────────────────────────┐
│ SESSION MEMORY my-app │
├─────────────────────────────────────────────────────────────────┤
│ Last Progress: Implemented OAuth2 login flow │
│ │
│ Completed: │
│ ✓ Database schema design │
│ ✓ User model with bcrypt │
│ ✓ JWT token generation │
│ │
│ Pending: │
│ ○ Refresh token rotation │
│ ○ Password reset flow │
│ │
│ Known Issues: │
│ ! Token expiry not handled in middleware │
└─────────────────────────────────────────────────────────────────┘
When you recover a session, this context is automatically injected.
Track progress on Claude's implementation plans. See phases, tasks, and completion rates.
┌─────────────────────────────────────────────────────────────────┐
│ PLANS │
├─────────────────────────────────────────────────────────────────┤
│ Auth System Refactor ████████░░ 80% │
│ Phase 1: Database Schema ✓ Complete │
│ Phase 2: API Endpoints ✓ Complete │
│ Phase 3: Frontend Integration ● In Progress │
│ Phase 4: Testing ○ Pending │
└─────────────────────────────────────────────────────────────────┘
Beautiful, cyberpunk-themed dashboard with 5 color themes.
| Sessions | Analytics | Projects |
|---|---|---|
 |
 |
 |
Keyboard shortcuts:
r— Refresh sessionss— Sync from Claude/— Focus searcht— Cycle themes?— Show help
Themes: Cyberpunk, Matrix, Synthwave, Minimal, Tokyo
# Core commands
claude-hub # Start web dashboard (default)
claude-hub list # List all sessions
claude-hub watch # Live terminal monitor
claude-hub recover <id> # Recover a lost session
# Session management
claude-hub list -s running # Filter by status
claude-hub list -d ./my-app # Filter by directory
# Memory management
claude-hub memory list # List session memories
claude-hub memory show <id> # Show memory details
claude-hub memory export <id> # Export as recovery context
# Background service
claude-hub daemon start # Start background monitor
claude-hub daemon stop # Stop daemon
claude-hub hooks install # Install Claude hooks┌─────────────────────────────────────────────────────────────────┐
│ Claude Hub │
├─────────────┬─────────────┬─────────────┬─────────────┬─────────┤
│ Web UI │ Terminal │ Daemon │ Hooks │ API │
│ (React) │ (Ink) │ (Background)│ (HTTP) │ (REST) │
├─────────────┴─────────────┴──────┬──────┴─────────────┴─────────┤
│ │ │
│ ┌───────────────────────────────▼────────────────────────────┐ │
│ │ Session Service │ │
│ │ • Aggregates process state + file state │ │
│ │ • Detects running/waiting/idle/lost sessions │ │
│ │ • Calculates costs with cache token support │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │ │
├──────────────────────────────────┼───────────────────────────────┤
│ Process Scanner │ Claude Parser │ Memory System │
│ (ps + /proc) │ (~/.claude/) │ (SQLite) │
└─────────────────────┴───────────────────┴────────────────────────┘
Data flow:
- Process Scanner — Finds all running
claudeprocesses - Claude Parser — Reads JSONL session files from
~/.claude/ - Aggregator — Merges process state with file state
- Memory System — Persists progress for recovery
- Web/CLI — Presents unified view
| Feature | Manual | claude-mem | Claude Hub |
|---|---|---|---|
| Multi-session monitoring | - | - | Yes |
| Session recovery | - | - | 3 methods |
| Cost tracking | - | - | Yes + predictions |
| Cache token analysis | - | - | Yes |
| Cross-session memory | - | Yes | Yes |
| Web dashboard | - | Basic | 5 themes |
| Plans tracking | - | - | Yes |
| Real-time hooks | - | Yes | Yes |
| Background daemon | - | - | Yes |
| Sub-agent tracking | - | - | Yes |
Data stored in ~/.claude-hub/:
~/.claude-hub/
├── claude-hub.db # SQLite database
├── config.json # Configuration
└── logs/ # Log files
{
"scanInterval": 5000,
"hookPort": 7890,
"webPort": 3377,
"logLevel": "info"
}REST API available at http://localhost:3377/api
| Endpoint | Description |
|---|---|
GET /sessions |
List all sessions |
GET /sessions/:id |
Session details |
POST /sessions/:id/recover |
Recover session |
GET /memory |
List memories |
GET /memory/:id/context |
Get recovery context |
GET /plans |
List plans |
GET /usage |
Cost analytics |
WS /ws |
Real-time updates |
Contributions welcome! See CONTRIBUTING.md.
# Development
bun run dev # Watch mode
bun run typecheck # Type check
bun test # Run tests- Cost alerts & budgets
- Team dashboard
- Cursor/Copilot support
- Session replay/timeline
- Plugin system