Codex Meter 🦀
A little macOS desktop companion for Codex: see your remaining account quota, follow local tasks, and keep a pixel crab beside your work.
Built by Tori Tao with Codex and Claude. Seven pixel scenes share a character-landscape style powered by Tori Patterns.
Latest: Codex Meter v1.5.2 / build 12 · macOS 13+ · Apple Silicon.
Download Codex Meter · Installation and usage notes · Tori's portfolio
Looking for the Claude version? Visit Claude Meter.
Codex Meter v1.5.2 — download / restore
The GitHub archive commit and the source commit inside the bundle are separate histories. Use the source ZIP or bundle to build the app, rather than the root archive repository.
Existing Mac installation
Quit Codex Meter, unzip the app archive, and place Codex Meter.app in ~/Applications/. Open it after signing in to the official Codex app on that Mac. macOS 13+, Apple Silicon and Apple Command Line Tools / Python 3 are required. The app uses local ad-hoc signing and is not Apple-notarized; new machines may need to build it locally. Intel is not verified.
Build from source
Unzip the complete backup and enter Codex-Meter-v1.5.2. Install Apple Command Line Tools if needed, then run:
xcode-select --install # only if Command Line Tools are not already installed
python3 -m unittest -v test_bridge.py
./build.sh
mkdir -p "$HOME/Applications"
ditto --norsrc --noextattr "/private/tmp/codex-meter-build/Codex Meter.app" "$HOME/Applications/Codex Meter.app"
open "$HOME/Applications/Codex Meter.app"
JavaScript checks, if Node.js is installed: node --test test_task_nav.cjs test_pet.cjs test_language.cjs.
Restore the Git repository using:
git clone Codex-Meter-v1.5.2-backup.bundle codex-meter-source
cd codex-meter-source
git checkout v1.5.2
New in v1.5.2
White codex identity in all sizes, aligned compact-panel labels, improved artwork spacing, and a persistent Chinese / English panel toggle beside Refresh in the full panel. Native menus and notifications remain Chinese. The scene artwork previews below were created for v1.5.1 and remain unchanged.
Previous v1.5.1 archives and checksums are retained.
Seven matching scenes
| Deep work | Cooking ideas | In the flow |
|---|
| | |
| A new perspective | Above the clouds | Take your time |
|---|
| | |
All eight PNGs are 1280 × 720. They contain artwork only, with no personal task titles or account usage. Video outline and Chinese / English X post drafts are ready for the next editing session.
What the Codex version does today
- Reads real Codex account quota windows and reset times; quota percentage is not an API balance or a remaining-token count.
- Shows one selected task at a time, with arrows for navigation and reply-needed prompts.
- Five working activities, music while waiting, confetti when a turn finishes.
- Full, compact and pet-only modes; native macOS glass with light / dark appearance.
- Reads local state and the official read-only quota endpoint. Monitoring and cached scenery do not call a model.
Completion means the current response turn ended, not that the whole project is finished. Permission approval popups cannot all be detected reliably. Only recent, unarchived tasks with local logs on this Mac are covered. The Codex app monitors Codex; the separate Claude app has its own public repository.
Credits and earlier backup
Based on Bon Yeung’s Claude-Meter. Original UI and pixel character © 2026 Bon Yeung; original documentation and attribution remain in UPSTREAM.md and source comments. Character landscapes adapt Tori Patterns Photo Lab, with visual inspiration from Claude FM. Unofficial, not an OpenAI or Anthropic product.
The v1.3.0 complete backup, app and bundle remain available. Backups exclude API keys, login credentials, task logs, usage caches and personal app preferences.
