ClaudeCodeMonitor

ClaudeCodeMonitor

  English | 日本語

A macOS menubar application that monitors Claude Code API usage and costs in real-time.

This app wraps the ccusage CLI tool to provide visual, easy-to-understand usage tracking for Claude Code.

✨ Key Features

Session-Based Monitoring
- Real-time Display: Shows current session usage percentage in the menubar
- Session Management: Accurate tracking based on Claude Code's 5-hour sessions
- Plan Support: Auto-detection and manual setting for Pro/Max5/Max20 plans
Detailed Usage Analytics
- 📊 Current Session Information
  - Remaining tokens and percentage
  - Session cost (reference value)
  - Burn rate (tokens/minute)
  - Time remaining prediction
- 📈 Historical Data
  - Daily usage and costs
  - Model-specific breakdown
  - Past session history

Additional Features
- 🔄 Auto-refresh every 5 minutes
- 🔄 Manual refresh button
- ⚙️ Plan settings (Pro/Max5/Max20)
- 🌍 Multi-language support (English/Japanese)

🚀 Installation

Download

Download the latest release from GitHub Releases.

📋 Requirements

- macOS 13.0 or later
- Swift 5.9 or later
- Bun or Node.js 18 or later (required for ccusage CLI tool)
- Xcode 15 or later (for development)

🛠️ Setup

1. Clone the Repository

2. Build Instructions

Method 1: Using Xcode (Recommended)

In Xcode:
- Build: Product > Build (⌘B)
- Run: Product > Run (⌘R)

Method 2: Command Line Build

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

How to Contribute

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Create a Pull Request

📝 License

This project is licensed under the MIT…