Skip to content

codeninja/claude-code-command-center

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code Command Center (cccc)

A web-based monitoring and interaction hub for Claude Code sessions. Get real-time visibility into active Claude processes, browse session history, track usage costs, and chat with running sessions — all from a single dashboard.

Python 3.12+

Features

  • Live Process Monitor — See all running Claude Code processes with PID, model, working directory, CPU, and memory usage. Auto-refreshes every 5 seconds via HTMX.
  • Session Browser — Browse session conversations across all projects, including subagent threads, with messages color-coded by role (user, assistant, subagent, tool call).
  • Plans & Tasks — View active plans and task lists associated with each session.
  • Usage & Cost Tracking — Dashboard stats pulled from Claude's stats-cache.json.
  • Session History — Recent global history from ~/.claude/history.jsonl.
  • Chat Interaction — Send messages to running sessions directly from the web UI (uses claude --print --resume).
  • PID-to-Session Resolution — Navigate to a session by PID with automatic resolution via open files, env vars, CWD matching, and most-recent fallback.

Quick Start

Requires uv and Python 3.12+.

# Clone and install
git clone <repo-url> && cd claude-code-command-center
uv sync

# Run
uv run cccc

The dashboard is served at http://localhost:18799.

Alternative run methods

uv run python -m src.main                                          # Direct module execution
uv run uvicorn src.main:app --host 0.0.0.0 --port 18799 --reload  # With auto-reload

How It Works

The app reads directly from Claude Code's local filesystem (~/.claude/) — no API keys or external services needed.

~/.claude/
├── projects/{encoded-path}/{session-id}.jsonl      # Session conversations
├── projects/{encoded-path}/{session-id}/subagents/  # Subagent conversations
├── plans/{session-id}*.md                           # Session plans
├── tasks/{session-id}/*.json                        # Active tasks
├── history.jsonl                                    # Global history
└── stats-cache.json                                 # Usage statistics

Tech Stack

  • FastAPI — Async backend with Jinja2 templates
  • HTMX — Live polling updates without heavy JavaScript
  • Tailwind CSS — Dark-themed UI via CDN
  • psutil — Process discovery and system monitoring

About

Full-screen Claude Code command center for monitoring and interacting with active sessions.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors