Claude HQ - A real-time command center for Claude Code sessions
npm install claudehqA real-time command center for all your Claude Code sessions.
- 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
``bashInstall hooks (one time)
npx claudehq setup
Open http://localhost:3456 - done!
Screenshots
$3
Track tasks across all your Claude sessions with automatic dependency management.$3
View and edit task properties, dependencies, and blocking relationships.$3
Create new tasks and define what they're blocked by or what they block.$3
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 sessionsCommands
`bash
npx claudehq # Start server
npx claudehq setup # Install Claude Code hooks
npx claudehq status # Check installation
npx claudehq uninstall # Remove hooks
`Or install globally:
`bash
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
`bash
Check status
npx claudehq statusTest hook manually
echo '{"hook_event_name":"PreToolUse","session_id":"test"}' | ~/.claude/hooks/tasks-board-hook.shView events
tail ~/.claude/tasks-board/events.jsonl
``MIT