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

``bash

`Install hooks (one time)`


npx claudehq setup
Start the dashboard

npx claudehq


Open http://localhost:3456 - done!
Screenshots
$3

Track tasks across all your Claude sessions with automatic dependency management.
!Task List
$3

View and edit task properties, dependencies, and blocking relationships.
!Task Detail
$3

Create new tasks and define what they're blocked by or what they block.
!Create Task
$3

Watch Claude work in real-time with tool calls, responses, and conversation history.
!Activity Feed
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`

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

Features

Install hooks (one time)

npx claudehq setup

Start the dashboard

npx claudehq

Open http://localhost:3456 - done!

Screenshots

$3

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

!Task List

$3

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

!Task Detail

$3

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

!Create Task

$3

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

!Activity Feed

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

How It Works


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