ClaudeMeter

Monitor your Claude AI usage quotas directly from your menu bar

Installation • Features • Setup • Development

---

Features

Feature	Description
📊 Real-time Monitoring	Track your 5-hour session and 7-day usage limits
🎨 Color-coded Indicators	Green (<70%), Orange (70-90%), Red (>90%) at a glance
⚡ Smart Refresh	Auto-adjusts refresh rate based on your usage level
🔐 Secure Storage	Credentials stored in system Keychain/Credential Manager
🖥️ Cross-platform	Native support for macOS, Windows, and Linux
🔄 Auto-updates	Automatically checks for and installs new versions
🌙 Dark Mode	Seamlessly adapts to your system theme

Installation

macOS

Option 1: Direct Download

1. Download the latest .dmg from Releases
2. Open the DMG and drag ClaudeMeter to Applications
3. Launch from Applications (you may need to right-click → Open on first launch)

Option 2: Homebrew (coming soon)

brew install --cask usage4claude

Windows

1. Download the latest .msi from Releases
2. Run the installer
3. Launch ClaudeMeter from the Start Menu

Linux

AppImage:

chmod +x ClaudeMeter_*.AppImage
./ClaudeMeter_*.AppImage

Debian/Ubuntu:

sudo dpkg -i usage4claude_*.deb

Getting Your Session Key

ClaudeMeter needs your Claude session key to fetch usage data. Here's how to get it:

📋 Step-by-step Instructions

Chrome / Edge / Brave

1. Go to claude.ai and sign in
2. Press F12 (or Cmd+Option+I on macOS) to open Developer Tools
3. Click the Application tab
4. In the left sidebar, expand Cookies → https://claude.ai
5. Find sessionKey in the list
6. Double-click the Value column to select it, then copy (Ctrl+C / Cmd+C)

Firefox

1. Go to claude.ai and sign in
2. Press F12 to open Developer Tools
3. Click the Storage tab
4. Expand Cookies → https://claude.ai
5. Find sessionKey and copy its value

Safari

1. Enable Developer menu: Safari → Settings → Advanced → "Show Develop menu"
2. Go to claude.ai and sign in
3. Press Cmd+Option+I to open Developer Tools
4. Click Storage → Cookies → claude.ai
5. Find sessionKey and copy its value

🔒 Privacy Note: Your session key is stored locally in your system's secure credential storage (Keychain on macOS, Credential Manager on Windows). It is never sent anywhere except directly to Claude's API.

Screenshots

Quick usage overview	Settings panel
Easy setup wizard	Menu bar integration

Development

Prerequisites

• Node.js 20+
• Rust (latest stable)
• Platform-specific dependencies:
  • macOS: Xcode Command Line Tools
  • Linux: libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev
  • Windows: Microsoft Visual Studio C++ Build Tools

Quick Start

# Clone the repository
git clone https://github.com/itsmylife44/claudemeter.git
cd claudemeter

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

Available Scripts

Command	Description
npm run tauri dev	Start development server with hot reload
npm run tauri build	Build production binaries
npm run test	Run frontend tests
npm run check	TypeScript type checking
cd src-tauri && cargo test	Run Rust backend tests

Project Structure

claudemeter/
├── src/                    # Svelte frontend
│   ├── lib/components/     # UI components
│   ├── lib/types/          # TypeScript types
│   └── routes/             # SvelteKit routes
├── src-tauri/              # Rust backend
│   └── src/
│       ├── api/            # Claude API client
│       ├── credentials/    # Secure storage
│       ├── tray/           # System tray
│       └── lib.rs          # Tauri commands
└── docs/                   # Screenshots & docs

Tech Stack

Layer	Technology
Frontend	Svelte 5 + TypeScript
Backend	Rust + Tauri v2
Testing	Vitest (frontend) + Cargo test (backend)
CI/CD	GitHub Actions

API Disclaimer

⚠️ This application uses Claude's unofficial internal API to fetch usage data. This API is not publicly documented and may change at any time without notice.

If Anthropic modifies their API, this application may stop working until updated. Use at your own discretion.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

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

License

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

Acknowledgments

• Built with Tauri and Svelte
• Inspired by Claude-Usage-Tracker

---

Made with ❤️ for the Claude community