Claude Code Realtime Dashboard

July 22, 2025 · View on GitHub

A real-time monitoring and visualization system for Claude Code sessions and sub-agent activities.

Project Structure

claude-code-realtime-dashboard/
├── backend/                # Backend Python packages
│   ├── core/               # Core components and utilities
│   │   ├── __init__.py
│   │   └── config.py       # Configuration management
│   ├── data/               # Data processing and storage
│   ├── integration/        # Integration with Claude Code
│   ├── realtime/           # Real-time communication
│   └── __init__.py
├── frontend/               # Frontend assets
│   ├── css/                # Stylesheets
│   ├── js/                 # JavaScript modules
│   │   ├── components/     # UI components
│   │   └── services/       # Frontend services
│   └── static/             # Static assets
├── scripts/                # Utility scripts
├── docs/                   # Documentation
├── dashboard.py            # Main entry point
└── README.md               # This file

Requirements

  • Python 3.14+
  • No external dependencies (standard library only)
  • Existing Claude Code Event Notifier infrastructure

Setup and Usage

  1. Ensure Python 3.14+ is installed
  2. Clone this repository
  3. Run the dashboard:
uv run --python 3.14 dashboard.py

Command Line Options

uv run --python 3.14 dashboard.py [--host HOST] [--port PORT] [--debug]
  • --host: Host to bind the server to (default: localhost)
  • --port: Port to bind the server to (default: 8000)
  • --debug: Enable debug logging
  • --claude-hooks-dir: Override Claude hooks directory path
  • --version: Show version information

Configuration

The dashboard can be configured through:

  1. Environment variables:

    • DASHBOARD_HOST: Server host
    • DASHBOARD_PORT: Server port
    • DASHBOARD_MAX_CONNECTIONS: Maximum connections
    • DASHBOARD_TIMEOUT: Connection timeout in seconds
    • CLAUDE_HOOKS_DIR: Claude hooks directory
    • DASHBOARD_LOG_LEVEL: Logging level
    • DASHBOARD_LOG_FILE: Log file path

  2. Command line arguments (override environment variables)

Development

The project follows a modular architecture with clear separation of concerns:

  • Core configuration and utilities
  • Data processing and storage
  • Integration with Claude Code
  • Real-time communication
  • Frontend visualization

License

[License information]