ccdash/README.md

Claude Code Dashboard - A comprehensive monitoring dashboard for Claude Code

# CCDash - Claude Code Dashboard

A comprehensive monitoring dashboard for Claude Code usage and analytics.

## Installation

```bash
npm install -g ccdash
```

## Usage

```bash
# Start with default ports
ccdash

# Start with custom ports
ccdash --backend-port 8081 --frontend-port 3001

# Show help
ccdash help
```

## Features

- Monitor Claude Code usage and token consumption
- Track sessions and activities with 5-hour time windows
- Web-based dashboard for visualization
- Cross-platform support (macOS, Linux, Windows)
- Command-line management tools

## Requirements

- Node.js 18+
- Modern web browser

## What's Included

This package includes:
- Pre-built backend binaries for all supported platforms
- Pre-built frontend assets (No additional build step required)
- Self-contained runtime with minimal dependencies

## API Access

When running, CCDash provides:
- Backend API: `http://localhost:8080`
- Frontend UI: `http://localhost:3000` (when available)

## Support

For issues and feature requests, visit: https://github.com/satoshi03/ccdash