Analytics Dashboard

The Analytics Dashboard provides comprehensive real-time monitoring of your Claude Code usage, conversations, and performance metrics.

Launch Analytics

Basic Launch

Start the analytics dashboard:

cct --analytics

This:

Starts web server on http://localhost:3333
Opens dashboard in your default browser
Begins real-time monitoring

With Remote Access

Enable Cloudflare Tunnel for remote access:

cct --analytics --tunnel

Generates a public URL like:

https://analytics-abc123.trycloudflare.com

Access from any device with internet connection.

Specific Views

Open to specific dashboard pages:

# Open to agents view
cct --agents

# Open to Year in Review 2025
cct --2025

Dashboard Features

Overview Page

The main dashboard shows: Real-time Statistics:

Total conversations
Token usage (input/output)
Cache usage (creation/read)
Active projects count
Last activity timestamp

Recent Conversations:

Conversation list with timestamps
Project names and paths
Message counts
Token usage per conversation
Conversation states (active/completed)

Activity Heatmap:

Visual representation of daily activity
Hour-by-hour usage patterns
Peak usage times
Activity trends

Agents Analytics

Dedicated agent performance tracking:

cct --agents

Metrics:

Agent usage frequency
Average tokens per agent
Success rates
Response times
Popular agents

Analysis:

Most used agents
Agent effectiveness
Usage patterns
Recommendations

Session Data

Max plan usage tracking: Session Limits:

Current session count
5-hour rolling window
Remaining messages
Reset time

Historical Data:

Session history
Usage patterns
Peak periods

Conversation Details

Detailed conversation breakdown: For each conversation:

Project name and path
Creation timestamp
Last update time
Message count
Total tokens (input/output)
Cache tokens (creation/read)
Tool usage statistics
Conversation state

Token Analytics

Input Tokens:

Total input tokens
Average per message
Trends over time

Output Tokens:

Total output tokens
Average per response
Generation patterns

Cache Tokens:

Cache creation tokens
Cache read tokens
Cache efficiency

Project Analytics

Active Projects:

Project names
Last activity
Conversation counts
Token usage per project
Project status

Project Insights:

Most active projects
Token consumption by project
Project trends

Year in Review 2025

Comprehensive annual usage statistics:

cct --2025

Metrics Included

Usage Stats:

Total conversations
Total messages
Total tokens
Active days
Average daily usage

Top Lists:

Most used agents
Most active projects
Busiest days
Peak hours

Achievements:

Milestones reached
Productivity metrics
Growth trends

Visualizations:

Usage timeline
Activity calendar
Token distribution
Agent usage breakdown

Real-Time Updates

The dashboard updates automatically: WebSocket Connection:

Real-time data streaming
Instant conversation updates
Live token counting
State change notifications

Refresh Intervals:

Conversations: Live updates
Statistics: Every 5 seconds
Charts: Every 10 seconds

Analytics Options

boolean

Launch analytics dashboard

boolean

Enable Cloudflare Tunnel for remote access (use with —analytics)

boolean

Launch analytics dashboard with agents view

boolean

Launch Year in Review 2025 dashboard

boolean

Enable verbose logging for debugging

Configuration

Port Configuration

Default port: 3333 To use a different port, modify environment:

PORT=8080 cct --analytics

Data Sources

Analytics reads from:

~/.claude/                    # Claude Code directory
~/.claude/conversations/      # Conversation history
~/.claude/statsig/            # Usage statistics

Cache Configuration

Data caching for performance:

Cache duration: 60 seconds
Refresh interval: 5 seconds
Memory threshold: 300 MB

Performance Monitoring

System Resources

The dashboard monitors: Memory Usage:

Current memory consumption
Memory threshold (300 MB)
Garbage collection triggers

Performance Metrics:

Data load times
Query performance
WebSocket latency

Optimization

For large conversation histories:

Cleanup old conversations:

# Set retention policy
cct --setting retention/retention-7-days

Limit conversation loading:
- Dashboard loads last 1000 conversations
- Older conversations available on demand
Use cache effectively:
- Data cached for 60 seconds
- Reduces file system reads

Cloudflare Tunnel

Setup Remote Access

Enable public URL:

cct --analytics --tunnel

Output:

🌐 Cloudflare Tunnel:
✅ Public URL: https://analytics-abc123.trycloudflare.com
📱 Scan QR code to access from mobile

Security Considerations

Public URLs:

URLs are temporary (expire after session)
No authentication by default
Anyone with URL can access

Best Practices:

Use only when needed
Share URL privately
Close tunnel after use
Don’t share URLs publicly

Mobile Access

Access from mobile devices:

Launch with tunnel:
cct --analytics --tunnel
Scan QR code displayed in terminal
Or open generated URL in mobile browser

Chats Mobile Interface

Mobile-optimized conversation browser:

cct --chats
cct --chats-mobile

Features:

Touch-optimized UI
Quick conversation access
Search and filter
Swipe gestures
Responsive design

With Remote Access:

cct --chats --tunnel

Plugin Dashboard

Manage Claude Code plugins:

cct --plugins

Features:

Browse plugin marketplace
View installed plugins
Manage permissions
Enable/disable plugins

Skills Dashboard

Explore Claude Code skills:

cct --skills-manager

Features:

View installed skills
Explore skill catalog
Skill documentation
Installation status

Teams Dashboard

Multi-agent collaboration review:

cct --teams

Features:

Team session history
Agent collaboration metrics
Team performance
Collaboration patterns

Use Cases

1. Daily Monitoring

# Start day with analytics check
cct --analytics

# Review:
# - Yesterday's usage
# - Active conversations
# - Token consumption

2. Team Reporting

# Generate weekly report
cct --analytics

# Export metrics:
# - Screenshot dashboard
# - Note key statistics
# - Share with team

3. Performance Optimization

# Analyze token usage
cct --analytics

# Identify:
# - High token conversations
# - Inefficient patterns
# - Optimization opportunities

4. Mobile Monitoring

# Enable remote access
cct --analytics --tunnel

# Monitor from:
# - Smartphone
# - Tablet
# - Another computer

5. Agent Effectiveness

# Review agent performance
cct --agents

# Analyze:
# - Most used agents
# - Agent success rates
# - Usage patterns

Troubleshooting

Dashboard Won’t Open

Check port availability:

lsof -i :3333

Kill conflicting process:

kill -9 $(lsof -t -i :3333)

Use different port:

PORT=8080 cct --analytics

No Data Displayed

Verify Claude directory:

ls -la ~/.claude/
ls -la ~/.claude/conversations/

Check permissions:

chmod -R 755 ~/.claude/

Verify conversations exist:

find ~/.claude/conversations/ -name "*.json" | head

Slow Performance

Clear old conversations:

# Set retention policy
cct --setting retention/retention-7-days

# Manual cleanup
find ~/.claude/conversations/ -mtime +30 -delete

Increase memory threshold: Edit src/analytics.js (for advanced users).

Tunnel Connection Failed

Check network:

ping trycloudflare.com

Retry tunnel:

cct --analytics --tunnel

Use without tunnel:

cct --analytics

WebSocket Disconnects

Check firewall:

Allow WebSocket connections on port 3333
Disable firewall temporarily to test

Restart dashboard:

# Kill existing
pkill -f analytics

# Restart
cct --analytics

Advanced Usage

Custom Analytics

Extend with custom queries:

// Read conversation data
const fs = require('fs');
const path = require('path');
const homeDir = require('os').homedir();

const conversationsDir = path.join(homeDir, '.claude', 'conversations');
const conversations = fs.readdirSync(conversationsDir)
  .filter(f => f.endsWith('.json'))
  .map(f => JSON.parse(fs.readFileSync(path.join(conversationsDir, f))));

// Custom analysis
const totalTokens = conversations.reduce((sum, conv) => {
  return sum + (conv.usage?.input_tokens || 0) + (conv.usage?.output_tokens || 0);
}, 0);

console.log('Total tokens:', totalTokens);

Export Analytics Data

# Export to JSON
node -e "const fs = require('fs'); const data = require('$HOME/.claude/conversations/conversation-123.json'); fs.writeFileSync('export.json', JSON.stringify(data, null, 2));"

Integration with Monitoring Tools

Forward metrics to external tools:

// Example: Send to monitoring service
const metrics = {
  timestamp: Date.now(),
  conversations: conversationCount,
  tokens: totalTokens,
  projects: activeProjects.length
};

// POST to monitoring API
fetch('https://monitoring.example.com/metrics', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(metrics)
});

Next Steps

Health Check - Verify Claude Code setup
CLI Flags Reference - Complete flags documentation
Configuration Guide - Settings and config files
Environment Variables - Configure analytics

​Analytics Dashboard

​Launch Analytics

​Basic Launch

​With Remote Access

​Specific Views

​Dashboard Features

​Overview Page

​Agents Analytics

​Session Data

​Conversation Details

​Token Analytics

​Project Analytics

​Year in Review 2025

​Metrics Included

​Real-Time Updates

​Analytics Options

​Configuration

​Port Configuration

​Data Sources

​Cache Configuration

​Performance Monitoring

​System Resources

​Optimization

​Cloudflare Tunnel

​Setup Remote Access

​Security Considerations

​Mobile Access

​Chats Mobile Interface

​Plugin Dashboard

​Skills Dashboard

​Teams Dashboard

​Use Cases

​1. Daily Monitoring

​2. Team Reporting

​3. Performance Optimization

​4. Mobile Monitoring

​5. Agent Effectiveness

​Troubleshooting

​Dashboard Won’t Open

​No Data Displayed

​Slow Performance

​Tunnel Connection Failed

​WebSocket Disconnects

​Advanced Usage

​Custom Analytics

​Export Analytics Data

​Integration with Monitoring Tools

​Next Steps

Analytics Dashboard

Launch Analytics

Basic Launch

With Remote Access

Specific Views

Dashboard Features

Overview Page

Agents Analytics

Session Data

Conversation Details

Token Analytics

Project Analytics

Year in Review 2025

Metrics Included

Real-Time Updates

Analytics Options

Configuration

Port Configuration

Data Sources

Cache Configuration

Performance Monitoring

System Resources

Optimization

Cloudflare Tunnel

Setup Remote Access

Security Considerations

Mobile Access

Chats Mobile Interface

Plugin Dashboard

Skills Dashboard

Teams Dashboard

Use Cases

1. Daily Monitoring

2. Team Reporting

3. Performance Optimization

4. Mobile Monitoring

5. Agent Effectiveness

Troubleshooting

Dashboard Won’t Open

No Data Displayed

Slow Performance

Tunnel Connection Failed

WebSocket Disconnects

Advanced Usage

Custom Analytics

Export Analytics Data

Integration with Monitoring Tools

Next Steps