Skip to content

castdrian/codemon

Repository files navigation

codemon

Menu bar app that tracks your Claude and Codex usage — session, weekly, and credits — with a small floating widget. No sign-in: it reads the credentials the claude and codex CLIs already store on your Mac.

codemon screenshot 1 codemon screenshot 2 codemon screenshot 3

Features

  • One floating widget per provider, each with its own draggable position, showing only the limits that provider actually has
  • No sign-in flow: Claude usage comes from the claude CLI's Keychain credentials, Codex from ~/.codex/auth.json
  • Menu bar dropdown with per-provider usage percentages
  • Customizable global shortcut to toggle the widget
  • Auto-updates via GitHub releases

Requirements

macOS 13 Ventura or later.

Sign in with the CLIs you want tracked — run claude for Claude and codex for Codex. codemon reads those existing credentials and never asks for them itself. The first Claude read triggers a macOS Keychain prompt; choose Always Allow so it does not ask again.

Installation

Download the latest release from Releases, unzip, and move codemon.app to Applications.

Building from source

  1. Clone this repository.
  2. Open codemon.xcodeproj in Xcode 15+.
  3. Build and run (⌘R).

Support

If codemon is useful to you, consider buying me a coffee.

About

Menu bar app that tracks your ai usage

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages