Skillget

tokemon

skill
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in scripts/build-app.sh
  • rm -rf — Recursive force deletion command in scripts/build-release.sh
  • rm -rf — Recursive force deletion command in scripts/build-xcode.sh
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This is a macOS menu bar application that monitors Claude API usage and rate limits in real-time. It reads your local session data automatically to track token consumption and provides alerts before you hit limits.

Security Assessment
The tool accesses sensitive data, including local Claude session logs and system Keychain credentials. It also makes network requests to send webhook alerts to Slack and Discord, and connects to the Claude Admin API if budget tracking is enabled. The automated scan flagged a moderate security concern: `rm -rf` (recursive force deletion) commands are present in three build scripts. While this is a common practice for cleaning up build directories in Xcode/Swift projects, it poses a minor risk if those variables were ever maliciously manipulated. No hardcoded secrets or dangerous runtime permissions were detected. Overall risk is rated as Low to Medium.

Quality Assessment
The project is actively maintained with repository pushes as recent as today. It uses the permissive MIT license and includes clear installation instructions via Homebrew. However, community trust and visibility are currently very low, with only 6 GitHub stars. This means the codebase has not yet undergone widespread peer review from the open-source community.

Verdict
Use with caution. The application is active and well-structured, but the low community visibility means you should inspect the build scripts and source code yourself before installing.
SUMMARY

Free, open-source Claude usage monitor for macOS & Raycast. Track token limits, burn rate, per-project costs, team budgets, and get alerts before you hit rate limits.

README.md

Tokemon

A macOS menu bar app that monitors your Claude usage in real-time so you never hit a rate limit by surprise.

macOS 26+
Swift 6
License

What it does

Tokemon sits in your menu bar and shows your current Claude usage at a glance. It reads your session data automatically — no API keys to configure, no manual setup. Just install and go.

Who it's for: Developers on Claude Pro, Team, or Enterprise plans who use Claude Code or claude.ai and want to keep an eye on their rate limits.

Features

Menu bar monitoring

  • Live usage percentage in your menu bar with color-coded severity (green/orange/red)
  • 6 icon styles: traffic light (default), percentage text, battery, progress bar, icon + bar, compact number
  • Optional monochrome mode to match native macOS menu bar styling
  • Click to see detailed usage breakdown with reset timer

Floating window

  • Always-on-top compact window showing usage percentage
  • Configurable rows: 5-hour session, 7-day rolling, 7-day Sonnet
  • Remembers position between sessions
  • Toggle from the right-click context menu

Alerts & notifications

  • Configurable warning thresholds (50-90%)
  • macOS system notifications when approaching limits
  • Session reset notifications when usage drops back to 0%
  • Webhook alerts to Slack and Discord with customizable templates

Multi-profile support

  • Manage multiple accounts/profiles
  • Switch between profiles from the popover
  • Per-profile alert thresholds
  • Credentials synced from system Keychain or entered manually

Analytics & export

  • Usage trend charts with burn rate calculation
  • 30/90-day usage history
  • Project-by-project token breakdown (via JSONL logs)
  • Export to PDF, CSV, or shareable usage cards

Budget tracking (Admin API)

  • Organization admins can connect an Admin API key
  • Monthly budget gauge with cost forecasting
  • Per-project cost breakdown
  • Auto-alerts at 50%, 75%, 90% of budget
  • Team member usage visibility

Terminal integration

  • Export usage to ~/.tokemon/statusline for shell prompt integration
  • JSON status at ~/.tokemon/status.json for custom scripts
  • Configurable format with ANSI colors
  • One-click shell integration (zsh/bash)

Theming

  • Liquid Glass (default) — translucent glass effect using native macOS 26 Liquid Glass APIs
  • Native — follows system light/dark appearance
  • Light — clean light theme
  • Dark — warm orange accents

Auto-updates

  • Built-in update checking via Sparkle
  • One-click updates from the app

Installation

Homebrew (recommended)

brew install --cask richyparr/tokemon/tokemon

This handles downloading, installation, and future updates via brew upgrade.

Manual download

  1. Download Tokemon.zip from the latest release
  2. Unzip and move Tokemon.app to /Applications
  3. Double-click to open

Tokemon is signed with an Apple Developer ID and notarized by Apple, so it opens without Gatekeeper warnings.

Build from source

Requires Xcode 16+ and XcodeGen.

git clone https://github.com/richyparr/tokemon.git
cd tokemon
xcodegen generate
xcodebuild build -scheme Tokemon -destination 'platform=macOS,arch=arm64' -configuration Release

The built app will be in your Xcode DerivedData directory.

How it works

Tokemon reads your usage through two data sources:

  1. OAuth (primary) — Queries the usage endpoint using credentials from your macOS Keychain. This gives you accurate 5-hour session percentages, 7-day rolling usage, and reset timers. Credentials are picked up automatically if you're signed into Claude Code.

  2. JSONL logs (fallback) — Parses local conversation logs in ~/.claude/projects/ to estimate token usage when OAuth isn't available.

No data leaves your machine except calls to the usage endpoint. No telemetry, no analytics, no accounts.

Requirements

  • macOS 26.0 (Tahoe) or later
  • A Claude Pro, Team, or Enterprise subscription
  • For budget/team features: an Admin API key

Settings

Right-click the menu bar icon or press Cmd+, to access settings:

Tab What it configures
Profiles Add/manage accounts, sync from Keychain
General Refresh interval, data sources, launch at login
Appearance Theme, menu bar icon style, monochrome mode
Notifications Alert thresholds, Slack/Discord webhooks
Terminal Statusline export format, shell integration
Analytics Usage history charts, PDF/CSV export
Budget Monthly spending limits, cost forecasting
Admin Admin API key connection

Privacy

  • All data is stored locally on your Mac
  • Credentials are stored in the macOS Keychain
  • The only network calls are to the usage and token refresh endpoints
  • No telemetry, tracking, or third-party services
  • The app is not sandboxed (it needs access to ~/.claude for JSONL parsing)

Support

License

MIT

Reviews (0)

No results found