Claude Code Monitor

_{Let Claude code it. Enjoy your cup.}

A real-time Claude Code usage monitor built with Rust and Makepad.

English | 简体中文

🌍 Cross-Platform Support

This is a cross-platform application that runs on:

• 🖥️ macOS (10.15+)
• 🐧 Linux (Ubuntu, Debian, Arch, Fedora, etc.)
• 🪟 Windows (10/11)

We welcome everyone to help test the application on different platforms and report any issues!

✨ Features

• 🌐 Network Monitoring

  • Real-time ping latency detection
  • TCP connection speed testing
  • Automatic proxy detection and support

• 📊 Claude Code Usage Tracking

  • Live token usage monitoring
  • Session status display (Active/Completed)
  • 5-hour session reset countdown
  • Model usage tracking (opus-4, sonnet-4, etc.)
  • Cost statistics and calculations

• 📈 Historical Analytics

  • 7-day usage trend charts
  • Daily cost statistics
  • Cumulative usage costs
  • Based on actual token calculations, not cached values

• 🔔 System Integration

  • System tray icon with dropdown menu
  • Desktop notifications (network status changes, periodic usage reports)
  • Native macOS notification support
  • Real-time timestamp updates (per second)

• 🌍 Internationalization (i18n)

  • Multi-language support (English, Chinese, Japanese)
  • Automatic system language detection
  • Real-time language switching
  • All UI elements and tray menu fully localized

📸 Screenshots

GUI Mode

TUI Mode (Terminal UI)

🚀 Getting Started

Prerequisites

• macOS 10.15+ / Linux / Windows
• Rust 1.70+
• Claude Code CLI installed and authenticated
• Node.js 16+ (for ccusage commands)

Platform-specific Requirements

Linux:

• GTK3 development libraries
• libappindicator (for system tray support)
• libxdo (for keyboard shortcuts)

# Ubuntu/Debian
sudo apt install libgtk-3-dev libxdo-dev libappindicator3-dev

# Arch/Manjaro
sudo pacman -S gtk3 xdotool libappindicator-gtk3

# Fedora
sudo dnf install gtk3-devel libxdo-devel libappindicator-gtk3-devel

Note: Some GNOME-based distributions may require additional extensions for system tray support.

Installation

1. Clone the repository

   git clone https://github.com/zhanghandong/cc-monitor-rs.git
   cd cc-monitor-rs
   

2. Build the project

   For Linux users: Different distributions require different system tray libraries:

   • KDE Neon / Ubuntu with KDE: Use the provided build script

     ./build-linux.sh
     

   • Linux Mint / Ubuntu MATE: Standard build works

     cargo build --release
     

   • For detailed Linux build instructions, see Linux Tray Dependencies

   For macOS/Windows users:

   cargo build --release
   

3. Run the application

   GUI Mode (default):

   cargo run --release
   # Or use the binary directly:
   ./target/release/cc-monitor-rs
   

   Terminal UI Mode:

   cargo run --release -- --tui
   # Or use the binary directly:
   ./target/release/cc-monitor-rs --tui
   

Quick Start with ccm

After building, you can create a convenient alias:

# Create a symbolic link (Unix-like systems)
ln -s $(pwd)/target/release/cc-monitor-rs /usr/local/bin/ccm

# Or add aliases to your shell configuration
alias ccm='cargo run --release --bin cc-monitor-rs'
alias ccm-tui='cargo run --release --bin cc-monitor-rs -- --tui'

🎆 Usage Guide

Prerequisites

1. Ensure Claude Code is running:

   claude code
   

2. Choose your interface:

   • GUI Mode: Native window with system tray integration
   • TUI Mode: Terminal-based interface for SSH/remote access

GUI Mode Features

• Native window with real-time updates
• System tray icon with status menu
• Desktop notifications
• Language selector in UI
• Visual charts and indicators

TUI Mode Features

• Full monitoring in terminal
• Keyboard navigation
• ASCII/Unicode charts
• Color-coded status
• Language switching (l key)

Keyboard Shortcuts (TUI)

Install from Release

Download pre-built binaries for your platform:

• macOS (Intel)
• macOS (Apple Silicon)
• Linux x64
• Windows x64

🔧 Configuration

Proxy Settings

The application automatically detects system proxy settings. You can also configure via environment variables:

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

Update Intervals

• Network & usage status: Every second
• Historical data: Every 60 seconds
• Desktop notifications: Hourly

🏗️ Architecture

• UI Framework: Makepad - High-performance native UI
• Language: Rust - Safe, efficient, concurrent
• Async Runtime: Tokio - Background task management
• System Integration: tray-icon, notify-rust

Project Structure

src/
├── app.rs              # Main application entry
├── ui/                 # UI components
│   ├── main_screen.rs  # Main screen
│   └── widgets/        # Custom widgets
├── monitor/            # Monitoring modules
│   ├── network.rs      # Network monitoring
│   └── ccusage.rs      # Claude usage monitoring
├── background/         # Background tasks
└── tray.rs            # System tray

🤝 Contributing

Issues and Pull Requests are welcome!

Development Setup

1. Install Rust toolchain

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

2. Build and run

   cargo build
   cargo run
   

3. For continuous development

   cargo install cargo-watch
   cargo watch -x run
   

🗺️ Roadmap

Check out our development roadmap: ROADMAP.md | 中文版

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Makepad - Excellent Rust UI framework
• Robrix - Architecture reference
• Claude Code Team - For providing an excellent AI programming assistant

📞 Contact

• Author: Zhang Handong
• GitHub: @zhanghandong
• Project: https://github.com/zhanghandong/cc-monitor-rs

Built with ❤️ and Rust