codex-limit 0.1.0

macOS menu bar widget for Codex weekly limit burn rate.

CodexLimit

CodexLimit is a macOS menu bar widget that reads local Codex session logs and shows the weekly non-Spark Codex limit burn rate as a status item title.

The app does not call a network API. It reads CODEX_HOME or ~/.codex/sessions, records samples in:

~/Library/Application Support/CodexLimit/samples.jsonl

Install for Development

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[packaging]"

Install from PyPI

pip install "codex-limit[app]"
codex-limit

Run

python -m codex_limit

Click the menu bar title to open the graph popover. The title is the current burn multiple, where 1.0x means weekly quota is being consumed at the real-time replenishment pace.

Build a macOS App Bundle

python setup.py py2app
open dist/CodexLimit.app

The bundle is configured as a menu-bar-only accessory app and should not show a Dock icon. The app icon is generated from assets/CodexLimit.icns.

Install Locally

scripts/install.sh

The installer builds dist/CodexLimit.app, stops any running copy, installs to /Applications when writable or ~/Applications otherwise, and launches the app. Use scripts/install.sh --user to force ~/Applications, or scripts/install.sh --no-open to install without launching.

Test

python -m unittest discover -s tests

Release

Publishing uses the same trusted-publishing workflow as codexapi: create a GitHub release or push a v* tag, and .github/workflows/publish.yml builds and publishes the package to PyPI.