Vibe Bar

Read this in: English · 中文

Vibe Bar is a native macOS menu-bar app for Codex and Claude Code users who
want subscription quota, usage pace, local token cost, and service status in one
quiet desktop surface. It is built for developers who run OpenAI/Codex and
Anthropic/Claude Code side by side and want the important numbers visible
without opening multiple dashboards.

Working with an AI coding agent?

Two zero-context guides are written for AI agents (Claude Code, Codex,
Cursor, Aider, …). Hand either one to your agent and it can take over
from there:

• AGENT-DEPLOY.md — clone, build, package, smoke-test,
  and (with your confirmation) install into /Applications.
• AGENT-PR.md — branch, verify locally, and open a
  pull request that matches this repo's conventions.

Both files are designed to be self-contained — an agent with no prior
knowledge of the project can follow them top-to-bottom.

Highlights

• Menu-bar quota indicators for OpenAI/Codex and Anthropic/Claude Code.
• Overview dashboard with quota pace, status, cost history, and token totals.
• Provider detail pages for subscription utilization, model rankings, heatmaps,
  hourly burn rate, and live service status.
• Mini floating window with regular and compact layouts.
• Local-first cost tracking from CLI session logs.
• Privacy controls for retention, clearing derived cost data, and disabling
  cost history persistence.

Built For

Vibe Bar focuses on the two coding-agent workflows this repository cares about:

• Codex/OpenAI usage: subscription windows, reset timing, service status, and
  local Codex session cost/token history.
• Claude Code/Anthropic usage: quota/routine budget visibility, service status,
  and local Claude Code session cost/token history.
• Mixed daily work: compact menu-bar and mini-window views that let you compare
  pace, remaining quota, and recent spend without switching provider dashboards.

Screenshots

Provider Detail

Mini Window

Settings

What It Shows

Vibe Bar combines live quota and local usage analytics in one place:

• Current quota windows, reset times, remaining percentages, and pace markers.
• Cost totals for today, 7 days, 30 days, and all time.
• Top model usage and model ranking.
• Daily cost history and same-day hourly burn rate.
• Yearly contribution-style usage heatmaps.
• Service status for OpenAI and Anthropic.

The menu-bar item also supports a right-click context menu with full usage
lines, provider status, refresh, mini window, settings, and quit actions.

Privacy and Local Data

Runtime state is stored under the current user's home directory:

~/.vibebar/
├── settings.json
├── quotas/
├── cost_snapshots/
├── scan_cache/
├── service_status.json
└── cost_history.json

Vibe Bar reads local CLI credentials and Claude/Codex session JSONL logs. It
does not write to the CLI credential or session files. Derived cost and token
history stays on your Mac unless you choose to share or publish it yourself.

Claude web cookies are minimized to the required sessionKey value and stored
in Keychain. The resolved Claude organization ID is also stored in Keychain.
Older plaintext cookie files under ~/.vibebar/cookies/ are migrated into
Keychain and removed on first read.

Cost history retention is user-configurable in Settings and defaults to
Forever. Privacy Mode clears local cost history, snapshots, and scan cache, then
keeps cost data off disk while enabled. The Cost Data settings section also
includes a manual Clear Cost Data action.

Requirements

• macOS 26 or newer.
• Xcode 26 / Swift 6.2 toolchain.
• Local OpenAI/Codex and/or Claude credentials if you want live quota data.
• Local CLI session logs if you want cost and token history.

Build From Source

swift test
./Scripts/build_app.sh
open ".build/Vibe Bar.app"

The SwiftPM executable product is VibeBar. The packaging script builds the
executable, creates .build/Vibe Bar.app, copies the app icon and Info.plist,
and ad-hoc signs the bundle for local use.

For a debug build:

./Scripts/build_app.sh debug

For a release build:

./Scripts/build_app.sh release

Development Notes

• Package.swift defines the VibeBar executable and VibeBarCore library.
• Sources/VibeBarApp contains the SwiftUI/AppKit menu-bar app.
• Sources/VibeBarCore contains parsers, storage, privacy helpers, and usage
  calculation logic.
• Scripts/build_app.sh creates and ad-hoc signs the app bundle.
• Resources/AppIcon.icns is copied into the bundle during packaging.
• swift test covers parsers, settings, pricing, privacy persistence, and
  usage utilities.

Project Status

Vibe Bar is early public-release software. Expect fast iteration around
provider APIs, model pricing, packaging, and macOS design details.

License

Vibe Bar is licensed under the GNU Affero General Public License v3.0 only.
See LICENSE for the full license text.