Contributor install
macOS 14+, Xcode 16 or newer, Homebrew, and XcodeGen.
git clone https://github.com/henryvn27/cowlick.git
cd cowlick
brew install xcodegen
./Scripts/install_local.shInteractive mockup. Quota, price, and reset values are examples, not live account data.
Choose a state, or use the arrow keys, Home, and End to move between states.Check Codex from the menu bar.
Cowlick is a native Mac app for checking Codex sessions, quota, and approval requests from the menu bar. Open the notch to see more.
Release status No public binary yet. Cowlick will only publish a signed, notarized build.
- macOS 14+
- Universal Apple silicon + Intel build targets
- Notch or menu-bar mode
Three ways Cowlick shows its status.
The compact view shows quota. Opening it shows active work and approval requests. Each session keeps its own project and status.
Check quota and reset pace.
Cowlick compares recent usage with the time left until reset. API-price estimates are shown separately from organization billing.
- Quota pace
- Used or remaining, plus a marker for even spend through reset.
- Time to empty
- A direct warning when the observed pace would run out early.
- Billing accounts
- Codex quota uses one local identity. OpenAI and Anthropic organization billing accounts stay labeled and uncombined.
Unofficial reset forecast. Cowlick displays data from Will Codex Reset? as provided. It is not Cowlick data or a Cowlick estimate, and Cowlick does not warrant it.
Review a command before allowing it.
Each approval matches one pending request. Allow is not selected by default. A timeout, malformed response, or disconnected app does not grant permission.
- Authenticated locally A current request arrives over private IPC.
- Explicit every time Allow once or Deny is a deliberate action.
- Failure defers Codex keeps its normal approval UI.
What Cowlick keeps local.
Prompt previews are off by default. Cowlick has no analytics, Cowlick account, cloud backend, ads, or third-party crash reporter.
Lifecycle fields only. Local observation ignores prompt, message, command, tool-input, and result payloads. Approvals come only from authenticated hooks.
No prompt history. Full prompts and approval operations are not persisted.
No hidden aggregation. Provider accounts and cost coverage remain separate.
Build Cowlick from source.
The source is public today. A one-click binary and Homebrew cask will appear only after Developer ID signing, notarization, and clean-install verification pass.