CCSight

A dashboard for visualizing Claude Code session data. Browse sessions, view conversation timelines, analyze token usage, inspect tool calls, and stream live sessions.

Quick Start

npx ccsight

Or install globally:

npm install -g ccsight
ccsight

Opens at http://localhost:3179 automatically.

Features

• Dashboard - session count, daily activity chart, token usage overview
• Session Browser - browse all projects and sessions
• Conversation Timeline - full message history with tool call details
• Token Analytics - input/output/cache token breakdowns
• Tool Call Analysis - every tool invocation with inputs and outputs
• Live Streaming - watch active sessions update in real-time
• Subagent Viewer - inspect agent-spawned sub-conversations

CLI Usage

ccsight / ccsight serve

Start the dashboard server (default command).

ccsight                   # Start with defaults
ccsight --port 8080       # Custom port (default: 3179)
ccsight --no-open         # Don't auto-open browser

ccsight sessions / ccsight ls

List recent sessions.

ccsight sessions

ccsight stats

Show token usage summary.

ccsight stats

ccsight config

Manage configuration.

ccsight config            # Show current config
ccsight config --path     # Print config file path
ccsight config --reset    # Reset config to defaults

General

ccsight --help            # Show help
ccsight --version         # Show version

Configuration

Data sources are configured through the Settings page in the UI, or by editing ~/.ccsight.json.

By default, sessions are read from ~/.claude/projects/ (the standard Claude Code session directory).

{
  "dataSources": [
    {
      "id": "claude-code",
      "label": "Claude Code",
      "path": "~/.claude/projects",
      "enabled": true
    }
  ]
}

Development

git clone https://github.com/dxsun97/ccsight.git
cd ccsight
pnpm install
pnpm run dev

Starts the Vite dev server on port 3210 and the API server on port 3211.

Build

pnpm run build
pnpm start

Project Structure

ccsight/
  packages/
    shared/    @ccsight/shared   - Shared types and utilities
    server/    @ccsight/server   - Node.js HTTP server + CLI
    web/       @ccsight/web      - React frontend (Vite)

Tech Stack

• Frontend - React 19, React Router 7, Zustand, Tailwind CSS 4, Recharts
• Backend - Node.js native HTTP server, Server-Sent Events for live streaming
• Build - pnpm workspaces, Vite, TypeScript

License

MIT