Settings reference

Open Settings from the gear button in the Vibe Bar popover. The left sidebar contains app-wide pages, core providers, and every Misc provider instance. Use the search field when the list becomes long.

System and refreshing

Setting	Choices	Default	What it changes
Percent shows	Remaining / Used	Remaining	Reverses the percentage and forecast wording throughout the UI.
Refresh every	1, 3, 5, 10, or 30 minutes	10 minutes	Sets the scheduled quota refresh cadence.
Refresh when the popover opens	On / Off	Off	Requests fresh data when you open the popover.
Minimum open-refresh cooldown	1, 2, 5, or 10 minutes	1 minute	Prevents repeated popover opens from causing repeated provider requests.
Launch at login	On / Off	Off	Registers Vibe Bar as a macOS login item.

The open-refresh action applies to visible providers and never runs more often than the selected cooldown. A provider may still reject or delay a request; the last-updated time and connection health tell you whether new data landed.

The Updates row shows the installed version and lets you check the signed GitHub Release feed manually. Automatic update checks run once a day in Sparkle-enabled releases, but installation always requires confirmation.

Menu bar

The Menu Bar → Overview editor controls both the status item and the popover:

• Show in menu bar hides or shows the status item.
• Show title text adds the short VB label.
• Layout offers Icon Only, Single line, Two rows, and Compact.
• Display density offers Compact, Regular, and Spacious popovers.
• Fields chooses the quota buckets shown directly in the status item.
• Each selected field can have a short custom label.

The available field list follows provider capabilities. It includes the main 5-hour and weekly windows plus supported model- or plan-specific branches such as Codex Spark, Claude model limits, Gemini Web, AntiGravity, and Grok credits. If a provider stops returning a selected bucket, the field stays configured and can reappear after a later successful refresh.

Mini window

The mini window is an independent floating quota surface.

1. Pick Regular or Compact.
2. Select the fields for that mode.
3. Optionally replace field labels and branch-group labels.
4. Open the mini window from the popover header.

Regular and Compact keep separate field selections. Double-clicking the mini window switches between the two modes. Closing and reopening Vibe Bar restores whether the window was open and its last screen position.

Misc providers do not appear in the mini window. It is reserved for the dedicated ChatGPT/Codex, Claude, Gemini/AntiGravity, and Grok quota surfaces.

Core providers

Core-provider rows can be dragged into a preferred order. Hiding a provider removes its Overview card, contribution to totals, status tile, and tab, but does not delete its credentials, refresh configuration, or history.

Each provider page contains:

• an optional plan-label override—leave it blank to use the detected plan;
• a source selector where more than one route is supported;
• browser-cookie import or WebView login where available;
• route health and a manual connection check.

For exact source order and setup steps, see Core providers.

Misc providers and multiple accounts

Each Misc row has a visibility checkbox, drag handle, setup controls, clone button, and—on clones—a delete button.

• Hide keeps setup and credentials but removes the card from the Misc tab.
• Clone creates an independent instance of the same provider.
• Give cloned rows names such as Work and Personal.
• Each instance has separate credentials, cookie slots, quota cache, and settings.
• Removing a clone clears that clone's stored credentials and cached quota.

Some cookie-based providers support several cookie slots. Adding a slot keeps the existing ones and Vibe Bar averages quota values across the configured accounts. See Misc providers for the full setup map.

Cost Data

Vibe Bar estimates local CLI cost from supported session records. Web and desktop chat usage is not included.

Setting	Choices	Default
Keep history	Forever, 30 days, 90 days, 1 year, 3 years	Forever
Privacy mode	On / Off	Off

The retention choice applies to cost history and subscription fill history. Rescan cost logs rebuilds derived data from supported local records. Clear cost data removes the derived history, snapshots, and scan cache but does not delete provider-owned CLI session files.

Privacy Mode clears those derived cost files and keeps cost data off disk while enabled. Quota configuration and provider credentials are separate from this switch. See Costs and forecasts and Privacy and local data.

Where settings are stored

Non-sensitive preferences are written to ~/.vibebar/settings.json. Credentials, API keys, OAuth tokens owned by Vibe Bar, and imported cookies are stored in macOS Keychain instead. Editing settings.json by hand is not recommended; unknown or invalid values may be normalized on the next launch.