Claude HQ

A real-time command center for all your Claude Code sessions.

Features

• Session Discovery: Automatically discovers all running Claude Code sessions
• Real-Time Activity: Live stream of tool usage, prompts, and responses
• Task Management: View tasks organized by status with dependency tracking
• Linear-Inspired UI: Clean, modern interface with dark/light themes
• Zero Config: One command setup with automatic hook installation

Quick Start

# Install hooks (one time)
npx claudehq setup

# Start the dashboard
npx claudehq

Open http://localhost:3456 - done!

Screenshots

Task List with Dependencies

Track tasks across all your Claude sessions with automatic dependency management.

Task Details

View and edit task properties, dependencies, and blocking relationships.

Create Tasks with Dependencies

Create new tasks and define what they're blocked by or what they block.

Live Activity Feed

Watch Claude work in real-time with tool calls, responses, and conversation history.

Requirements

Required:

• Node.js 18+
• jq - brew install jq (macOS) or apt install jq (Linux)

Optional:

• tmux - brew install tmux (macOS) or apt install tmux (Linux)
  • Only needed if you want to spawn/control sessions from the dashboard
  • Not required for monitoring existing sessions

Commands

npx claudehq           # Start server
npx claudehq setup     # Install Claude Code hooks
npx claudehq status    # Check installation
npx claudehq uninstall # Remove hooks

Or install globally:

npm i -g claudehq
chq setup
chq

How It Works

Claude Code  ──▶  Hook Script  ──▶  Events File
                      │                  │
                      ▼                  ▼
                  ┌─────────────────────────┐
                  │      Claude HQ Server   │
                  └───────────┬─────────────┘
                              │ SSE
                              ▼
                  ┌─────────────────────────┐
                  │     Web Dashboard       │
                  │  • Sessions & Status    │
                  │  • Task Board           │
                  │  • Live Activity Feed   │
                  └─────────────────────────┘

Configuration

| Variable | Default | Description | |----------|---------|-------------| | PORT | 3456 | Server port | | TASKS_BOARD_DATA_DIR | ~/.claude/tasks-board | Data directory |

Troubleshooting

# Check status
npx claudehq status

# Test hook manually
echo '{"hook_event_name":"PreToolUse","session_id":"test"}' | ~/.claude/hooks/tasks-board-hook.sh

# View events
tail ~/.claude/tasks-board/events.jsonl

License

MIT