Skip to content

flipace/claudit

Repository files navigation

Claudit

A native desktop application that provides real-time usage analytics for Claude Code.

Claudit

Features

  • Real-time Analytics: Token consumption and cost tracking in the menu bar
  • Burn Rate: See your $/hour spending rate
  • Session Tracking: 5-hour session block monitoring
  • Project Insights: Per-project and per-model breakdowns
  • Interactive Dashboard: Charts for usage analysis (tokens, costs, models, projects)
  • Notifications: Get notified when Claude finishes responding
  • Project Browser: Browse all Claude Code projects with usage stats
  • AI Suggestions: Get Claude-powered suggestions to improve project workflow
  • Configuration Browser: View and manage Claude agents, commands, plugins, and MCP servers
  • Backup & Export: Backup your Claude configuration and history

Download

Currently available for macOS (Apple Silicon) only. Requires macOS 15.0+.

If you want to support the project, you can use Buy Me a Coffee.

Tech Stack

Layer Tech
Framework Tauri 2 (Rust + Webview)
Frontend React 18, Vite, TypeScript
Styling Tailwind CSS 3
Charts Recharts
Data Fetching TanStack Query
Animations Motion
Icons Lucide React
Distribution Direct download + build from source

Development

# Prerequisites: Node.js (>=20), pnpm, Rust toolchain, and Tauri prerequisites (Xcode).
#
# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

Project Structure

claudit/
β”œβ”€β”€ packages/
β”‚   └── frontend/           # React frontend
β”‚       └── src/
β”‚           β”œβ”€β”€ domains/    # Feature-based organization
β”‚           β”‚   β”œβ”€β”€ analytics/   # Dashboard with charts & stats
β”‚           β”‚   β”œβ”€β”€ settings/    # App preferences UI
β”‚           β”‚   β”œβ”€β”€ projects/    # Project browser & AI suggestions
β”‚           β”‚   β”œβ”€β”€ agents/      # Claude agents browser
β”‚           β”‚   β”œβ”€β”€ plugins/     # Claude plugins browser
β”‚           β”‚   β”œβ”€β”€ config/      # Claude config viewer
β”‚           β”‚   β”œβ”€β”€ analysis/    # Deep usage analysis
β”‚           β”‚   β”œβ”€β”€ backup/      # Backup management
β”‚           β”‚   └── shared/      # Shared domain components
β”‚           β”œβ”€β”€ components/      # Reusable UI components
β”‚           └── lib/             # Utilities
β”œβ”€β”€ src-tauri/              # Rust backend
β”‚   └── src/
β”‚       β”œβ”€β”€ services/       # Core services
β”‚       β”‚   β”œβ”€β”€ usage.rs    # JSONL parsing
β”‚       β”‚   β”œβ”€β”€ analytics.rs # Stats calculation
β”‚       β”‚   β”œβ”€β”€ hooks.rs    # HTTP server for hooks
β”‚       β”‚   β”œβ”€β”€ settings.rs # Preferences
β”‚       β”‚   └── config.rs   # Claude config & project management
β”‚       β”œβ”€β”€ tray.rs         # System tray menu
β”‚       └── lib.rs          # Main entry & Tauri commands
β”œβ”€β”€ landing/                # Landing page (claudit.cloud.neschkudla.at)
└── scripts/                # Build utilities

How It Works

  1. Claude Code writes usage data to ~/.claude/projects/**/*.jsonl
  2. Claudit parses JSONL files and deduplicates entries
  3. Analytics service calculates stats, costs, and burn rates
  4. System tray displays live stats (updates every 30s)
  5. Dashboard shows interactive charts and detailed breakdowns

Hook Integration

Claudit runs a local HTTP server to receive events from Claude Code hooks for real-time notifications. Configure hooks in the app's Settings page, or manually add to ~/.claude/settings.json:

{
  "hooks": {
    "Stop": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "curl -s -X POST http://localhost:3456/hook -H \"Content-Type: application/json\" -d '{\"event\": \"Stop\"}' > /dev/null 2>&1 &"
      }]
    }]
  }
}

License

MIT β€” see LICENSE.


Made by @flipace and Claude Code

About

A beautiful Claude Code management UI / built with Claude Code πŸ€–

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published