Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Vantage icon

Vantage

Keep an eye on Claude Code and Codex — right from your menu bar.

Vantage popover: rate limits, context-pressure board, and per-session cost cards

Two indicators in your menu bar show how much account headroom you have left. One click shows every live session at a glance — context, cost, subagents, and which one needs you. Local-only by default, with no telemetry or Vantage account.


Why Vantage

Running several Claude Code or Codex sessions at once, it's hard to know which one needs attention — which is about to hit a rate limit, which is nearly out of context, which is quietly burning money, and which is waiting on you. Vantage surfaces all of it natively, at a glance, without ever leaving your menu bar. Its default local mode keeps session data on your Mac.

Features

  • Account rate-limit gauges. Dynamic provider-owned limit windows as green→yellow→red bars with live reset countdowns. Vantage preserves separate model-scoped buckets when Claude or Codex supplies them instead of folding everything into one total.
  • Concurrent-session pressure board. Every live session as a context-fill bar, most-recently- active first — so you instantly see which one is about to need a /compact.
  • Rich per-session cards. Model, repo, git branch, token counts, lines changed, and a click-to-copy session ID. An idle-age badge and an inferred "awaiting your input?" badge flag the session that needs you.
  • A cost metric you choose. Pick one per card in Settings: Spend composition (where the dollars go), Cache savings ("you saved $X"), Effective $/Mtoken, or Subagent fan-out & delegation share.
  • Tidy by default. Sessions idle over 24 h tuck under "Older sessions"; the popover stays compact and fast.
  • Private by design. Zero telemetry and zero third-party SDKs. Local-only mode reads provider artifacts under ~/.claude and ~/.codex. Optional live Codex limits are disabled by default and use the installed official Codex CLI's existing sign-in; Vantage does not read its credentials or send transcript contents.

What's new in 1.0.1

  • Fixed automatic Codex account-limit readings with the official Codex app-server, including multi-bucket accounts, streamed changes, and periodic reconciliation.
  • Preserved Claude's additional model-specific limit buckets—including Fable 5—separately from the general limits.
  • Added a safe, user-initiated Claude status-line integration repair with a one-time backup and documented five-minute refresh interval.

Settings

Vantage Settings: pick the per-card cost metric and toggle the status badges

Choose the active provider, configure account-limit refresh, repair the Claude integration, select session-card metrics, and toggle attention badges from a single pane.

Requirements

Install

  1. Download Vantage-1.0.1-arm64.dmg and its checksum from the Releases page.
  2. Verify it in Terminal: cd ~/Downloads && shasum -a 256 -c Vantage-1.0.1-arm64.dmg.sha256.
  3. Open it and drag Vantage to your Applications folder.
  4. On first launch, Control-click Vantage, choose Open, then choose Open again to acknowledge Gatekeeper's warning. Two colored dots then appear in your menu bar.

Unsigned preview: v1.0.1 is not Developer ID-signed or notarized by Apple. Download it only from this repository's Releases page. A Developer ID-signed, notarized release is planned next.

How it works

Vantage reads the session data Claude Code and Codex already write under ~/.claude and ~/.codex. A bundled helper can be registered as Claude Code's documented statusLine.command to capture readings the transcript alone does not carry. When you explicitly enable live Codex limits, Vantage asks the installed official Codex CLI for the active account's limits; the CLI handles its own connection and authentication.

Support

Vantage is free. If it saves you time, you can leave a tip:

Appreciated — never required.


Built for people who run a lot of Claude Code and Codex. macOS · SwiftUI · local-first.

About

A native macOS menu-bar app for monitoring Claude Code sessions: rate limits, context, cost, and subagent activity. Local and private.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors