New:Socket for Asana Is Now Available.Learn more
Get Started

claude-hub

Package Overview
Dependencies
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

claude-hub

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

latest
Source
npmnpm
Version
1.0.0
Version published
Maintainers
1
Created
Source
Claude Hub Logo

Claude Hub

Never lose your Claude Code work again.

The command center for Claude Code power users

npm version npm downloads GitHub stars License

Quick Start | Features | Screenshots | Documentation


Claude Hub Demo

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 HubWith Claude Hub
Terminal crashLose all context, start overOne-click recovery with full context
Multiple sessionsSwitch terminals, lose trackSee all sessions in one dashboard
Cost trackingCheck Anthropic console manuallyReal-time costs with predictions
Session contextGone when terminal closesPersisted and searchable
Project overviewScattered across directoriesAggregated by project

Quick Start

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.

SessionsAnalyticsProjects
SessionsAnalyticsProjects

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

FeatureManualclaude-memClaude Hub
Multi-session monitoring--Yes
Session recovery--3 methods
Cost tracking--Yes + predictions
Cache token analysis--Yes
Cross-session memory-YesYes
Web dashboard-Basic5 themes
Plans tracking--Yes
Real-time hooks-YesYes
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

EndpointDescription
GET /sessionsList all sessions
GET /sessions/:idSession details
POST /sessions/:id/recoverRecover session
GET /memoryList memories
GET /memory/:id/contextGet recovery context
GET /plansList plans
GET /usageCost analytics
WS /wsReal-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

Keywords

claude

FAQs

Package last updated on 25 Dec 2025

Related posts