Pock CodexBar Widget

A Pock Touch Bar widget that shows remaining usage quota for AI CLI providers (Codex, Claude, and others) tracked by CodexBar.

Requirements

• Pock 1.10+
• The codexbar CLI installed and reachable from /opt/homebrew/bin, /usr/local/bin, or CodexBar.app, already set up and with at least one provider enabled (see below) — the widget only renders what codexbar returns, it does not do any auth/setup itself.

Set up CodexBar first

This widget is a thin display layer over the codexbar CLI — it will show "CodexBar CLI not found" or "No providers enabled" until CodexBar itself is installed and configured:

1. Install CodexBar: brew install --cask codexbar, or download a CLI tarball from CodexBar releases.
2. Enable the providers you want to track and sign in to each, either via the CodexBar app (Settings → Providers) or from the CLI, e.g.:

   codexbar config enable --provider codex
   codexbar config enable --provider claude

3. Confirm it works on its own before installing the widget:

   codexbar --format json --no-color

See the CodexBar CLI configuration guide for the full provider list and auth flows.

Install

1. Open pock-codexbar-widget.xcodeproj in Xcode (dependencies are resolved automatically via Swift Package Manager).
2. Build the pock-codexbar-widget target. The build phase installs the resulting .pock bundle into Pock automatically.
3. Enable "CodexBar" from Pock's widget manager.

Usage

• Click the widget to force an immediate refresh, bypassing the cache.
• Open the widget's preferences (from Pock's widget manager) to choose:
  • Usage window: automatic, session only, or weekly only
  • Refresh interval
  • Whether to show the reset countdown

License

Released under the MIT License.

Provider icons in Resources/ProviderIcons/ are sourced from CodexBar (MIT License, © Peter Steinberger).