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

git clone https://github.com/K9i-0/ClaudeCodeMonitor.git
cd ClaudeCodeMonitor

2. Build Instructions

Method 1: Using Xcode (Recommended)

open Package.swift

In Xcode:

• Build: Product > Build (⌘B)
• Run: Product > Run (⌘R)

Method 2: Command Line Build

# Build and create app bundle
./scripts/create-app-bundle.sh

🤝 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 License. See the LICENSE file for details.

🙏 Acknowledgments

• ccusage - CLI tool for fetching Claude usage
• Anthropic - The creators of Claude AI

🔗 Related Links

• Claude Code - Official Claude Code by Anthropic
• ccusage CLI - The underlying CLI tool