claude-hub

v1.0.0

Published

7 days ago

The command center for Claude Code - Never lose your work again

Downloads

0High
0Medium
0Low

lifcc

claude claude-code ai coding-assistant session-manager developer-tools terminal cli monitoring recovery

Claude Hub

Never lose your Claude Code work again.

The command center for Claude Code power users

Quick Start | Features | Screenshots | Documentation

The Problem

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?"

The Solution

Claude Hub monitors all your Claude Code sessions in real-time, automatically recovers crashed sessions, tracks costs, and preserves context across iterations.

npx claude-hub

That's it. Open http://localhost:3377 and take control.

Why Claude Hub?

| | 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 |

Quick Start

Option 1: npx (Recommended)

npx claude-hub

Option 2: Install globally

npm install -g claude-hub
claude-hub web

Option 3: From source

git clone https://github.com/majiayu000/claude-hub.git
cd claude-hub
bun install && bun run build
bun run start web

Open http://localhost:3377

Features

Real-time Session Monitoring

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      │
└─────────────────────────────────────────────────────────────────┘

One-Click Session Recovery

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

Cost Analytics & Predictions

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

Cross-Session Memory

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.

Plans Tracking

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      │
└─────────────────────────────────────────────────────────────────┘

Web Dashboard

Beautiful, cyberpunk-themed dashboard with 5 color themes.

| Sessions | Analytics | Projects | |:--------:|:---------:|:--------:| | | | |

Keyboard shortcuts:

r — Refresh sessions
s — Sync from Claude
/ — Focus search
t — Cycle themes
? — Show help

Themes: Cyberpunk, Matrix, Synthwave, Minimal, Tokyo

CLI Reference

# 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

How It Works

┌─────────────────────────────────────────────────────────────────┐
│                        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 claude processes
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

Comparison

| 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 |

Configuration

Data stored in ~/.claude-hub/:

~/.claude-hub/
├── claude-hub.db    # SQLite database
├── config.json      # Configuration
└── logs/            # Log files

Options

{
  "scanInterval": 5000,
  "hookPort": 7890,
  "webPort": 3377,
  "logLevel": "info"
}

API

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 |

Contributing

Contributions welcome! See CONTRIBUTING.md.

# Development
bun run dev          # Watch mode
bun run typecheck    # Type check
bun test             # Run tests

Roadmap

[ ] Cost alerts & budgets
[ ] Team dashboard
[ ] Cursor/Copilot support
[ ] Session replay/timeline
[ ] Plugin system

Support

Built for Claude Code power users

GitHub | npm | Documentation

MIT License