CCMeter

Project handling & performance

• Auto-discovery & grouping — finds Claude projects and groups them by git repository
• Multi-source roots — switch between Claude config directories with Shift+Tab
• Persistent cache — historical metrics cached locally for near-instant startup; only new sessions get parsed
• Responsive layout — heatmaps and card grids adapt to terminal size

Installation

Install script (recommended)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/hmenzagh/CCMeter/releases/latest/download/ccmeter-installer.sh | sh

Homebrew

Install prebuilt binaries via Homebrew:

brew install hmenzagh/tap/ccmeter

From source

git clone https://github.com/hmenzagh/CCMeter.git
cd CCMeter
cargo install --path .     # installs `ccmeter` to ~/.cargo/bin (make sure it's in $PATH)

Or build without installing — the binary will be at target/release/ccmeter:

cargo build --release

Requirements (from source): Rust 1.85+ and Cargo.

Usage

ccmeter

Keybindings

| Key | Action | |-----|--------| | Tab | Cycle time filter | | Shift+Tab | Switch source root | | j / k or Up / Down | Scroll projects | | h / l or Left / Right | Navigate between projects | | Esc | Deselect project | | . | Open settings panel | | r | Reload data | | q / Ctrl+C | Quit |

Settings panel

Press . to open the settings panel, where you can:

• Rename projects with custom display names
• Merge multiple projects into a single group
• Split sources out of auto-detected groups
• Star favorites (animated rainbow border)
• Hide projects from the dashboard

How it works

CCMeter discovers Claude Code sessions by scanning your home directory for any folder whose name contains claude and that has a projects/ subdirectory with session logs (so ~/.claude/projects, ~/.config/claude/projects, and other Claude-compatible CLIs are all picked up automatically). It parses JSONL session files in parallel using rayon, extracts token counts and model identifiers, and computes costs from built-in pricing tables.

Session JSONL → parallel parse → daily aggregates → cached history → TUI render

Cache

Parsed metrics are persisted to ~/.config/ccmeter/history.json. On subsequent launches, only new or modified session files are parsed, everything else is served from cache, making startup near-instant even with thousands of sessions.

Per-project view

Use h/l or arrow keys to select a project card. The dashboard switches to a detail view showing:

• Cost and token charts scoped to that project (daily or minute-level depending on time filter)
• Model distribution bar with per-model cost breakdown
• Active time estimate, sessions count, lines added/deleted, and efficiency gauge
• Heatmaps filtered to the selected project only

Press Esc to go back to the global overview.

Configuration

User overrides are stored at ~/.config/ccmeter/overrides.json and can be edited through the settings panel or manually.

Tech stack

| Crate | Role | |-------|------| | ratatui | Terminal UI framework | | crossterm | Terminal event handling | | clap | CLI argument parsing | | rayon | Parallel JSONL parsing | | chrono | Date/time handling | | serde / serde_json | Serialization & JSONL parsing | | dirs | Cross-platform home/config paths |

Project structure

src/
├── main.rs               # Entry point & event loop
├── app.rs                # Core application state
├── config/
│   ├── mod.rs
│   ├── discovery.rs      # Project auto-discovery
│   └── overrides.rs      # User configuration & merges
├── data/
│   ├── mod.rs
│   ├── parser.rs         # JSONL session parsing
│   ├── cache.rs          # Persistent metric cache
│   ├── tokens.rs         # Daily token aggregation
│   └── models.rs         # Model pricing tables
└── ui/
    ├── mod.rs
    ├── dashboard.rs      # Main layout
    ├── heatmap.rs        # Heatmap rendering
    ├── theme.rs          # Color theme
    ├── time_filter.rs    # Time range logic
    ├── settings_view.rs  # Settings panel
    └── cards/
        ├── mod.rs
        ├── data.rs       # Card data aggregation
        └── render.rs     # Card rendering

License

MIT