Brink

Know when you're on the brink. A tiny panel that lives on the right edge of your screen and shows your Claude Code, Codex and Cursor usage limits at a glance. For macOS and Windows.

Move the mouse to the thin strip on the right edge → the panel slides out. Hover a ring → a card shows the session limit, weekly limits and reset times.

No Dock icon, no menu bar clutter. Just the edge.

Features

• Three looks: Black, Liquid Glass and System. On macOS 26+ the glass is Apple's real, adaptive Liquid Glass (.glassEffect): it turns light or dark from what's behind it, so type stays legible over a white web page and a dark wallpaper alike. On macOS 13–15 it falls back to a frosted NSVisualEffectView blur.
• Notch-style tab that flares into the screen edge; rings scale on hover; the detail card glides between rings
• Notifications when a limit fills up — and again the moment it resets (scheduled for the reset time, so it arrives even if the app is idle)
• 10 languages — follows your macOS language automatically (English, Türkçe, Deutsch, Français, Español, Português (Brasil), Italiano, 日本語, 简体中文, 한국어); override in the menu
• Rings for each provider, colored by usage (green → yellow → red; Claude ring in Claude orange)
• Detail card with Current session, All models and per-model weekly limits (e.g. Fable / Opus / Sonnet)
• Auto-refresh every 2 minutes, manual refresh from the context menu
• Launch at login toggle (System Settings → Login Items compatible)
• Works with whatever CLIs you already have installed — no API keys, no accounts

Requirements

• macOS 13 Ventura or later, Apple Silicon or Intel (the DMG is a universal binary) — or Windows 10 (1809+) / 11 x64, see Windows
• Claude Code, Codex CLI and/or Cursor CLI (cursor-agent login) — whichever you use, logged in
• To build from source: Xcode Command Line Tools (xcode-select --install)

Install

Download

Grab Brink.dmg from the latest release, open it and drag Brink to Applications.

Or with Homebrew (from this tap; Brink isn't in homebrew-cask yet — that needs notarization first):

brew tap semihtalii/brink
brew trust semihtalii/brink     # Homebrew 6+ asks this once for third-party taps
brew install --cask brink

The cask strips the quarantine flag for you, so the Gatekeeper step below isn't needed.

The app is not yet notarized (no Apple Developer account yet), so macOS blocks the first launch. On macOS 15 Sequoia and later the old right-click → Open trick no longer works; do this instead:

1. Double-click Brink once — macOS says it can't be opened. Click Done.
2. Open System Settings → Privacy & Security, scroll down to Security and click Open Anyway next to Brink (the button only shows for about an hour after the blocked attempt; launch it again if it's gone).
3. Confirm with your password. You only do this once.

Or skip the dialogs entirely from a terminal:

xattr -d com.apple.quarantine /Applications/Brink.app

Every release ships a SHA256SUMS file and a GitHub build attestation, so you can check the DMG came from this repo's CI: gh attestation verify Brink.dmg -R semihtalii/brink.

Build from source

git clone https://github.com/semihtalii/brink.git
cd Brink
./build.sh
open dist/Brink.app

build.sh produces both dist/Brink.app and dist/Brink.dmg.

Windows

Brink for Windows is a native C# / WPF (.NET 8) port with the same behaviour: edge strip, rings, detail card, notifications, 10 languages, launch at login. Themes are Black and System (follows the Windows light/dark app theme; there is no Liquid Glass on Windows).

Install: grab Brink-Windows-x64.zip from the latest release, unzip, run Brink.exe. It's a single self-contained file — no .NET install needed (x64 only for now). The exe is not code-signed yet, so SmartScreen may warn on first run: More info → Run anyway.

A winget install SemihTali.Brink manifest is prepared in packaging/winget/ and will work once it's merged into winget-pkgs.

Uninstall: quit Brink, delete Brink.exe and %APPDATA%\Brink\. If you enabled Launch at login, turn it off first (it's a HKCU\...\Run entry).

Credentials it reads (never written, never sent anywhere but the vendor):

Settings and an error log live in %APPDATA%\Brink\. Source is in windows/; build with dotnet build windows/Brink.csproj -c Release.

First launch

macOS will ask once:

Brink wants to use your confidential information stored in "Claude Code-credentials" in your keychain.

Click Always Allow. This is Claude Code's own login token; Brink reads it to ask Anthropic for your usage numbers. It is never sent anywhere else.

Usage

Providers you're not signed in to are hidden. If nothing is signed in, a single ? ring tells you what to install; turn a provider on under Providers to see a DEMO ring anyway.

Uninstall (macOS): quit Brink, delete /Applications/Brink.app and ~/Library/Application Support/Brink/. Nothing else is written.

How it works

• Claude — reads the OAuth access token Claude Code stores in the macOS Keychain (Claude Code-credentials) or in ~/.claude/.credentials.json, then calls api.anthropic.com/api/oauth/usage — the same request Claude Code makes for its /usage command.
• Codex — reads the token in ~/.codex/auth.json and calls chatgpt.com/backend-api/wham/usage.
• Cursor — reads the Cursor CLI session token (Keychain cursor-access-token) and the user id from ~/.cursor/cli-config.json, then calls cursor.com/api/usage-summary.

Security & privacy

• Tokens are only ever sent to Anthropic's / OpenAI's own API hosts over HTTPS. There is no telemetry, no third-party server.
• Brink caches only the short-lived access token and its expiry in ~/Library/Application Support/Brink/credentials.json (mode 0600) so the Keychain prompt appears once rather than every refresh. It never stores or uses refresh tokens, and it never refreshes tokens on your behalf — so it cannot log you out of Claude Code.
• When the cached token expires, Brink re-reads Claude Code's own store. Opening Claude Code once is enough to get a fresh token.

Caveats

• These usage endpoints are not official, documented APIs. If Anthropic or OpenAI change the response shape, the parsers in ClaudeProvider.swift / CodexProvider.swift will need a small update. PRs welcome.
• The panel attaches to the main display only (v1).

When not to use this

• You want numbers inside the terminal or a status line → look at CLI tools such as llmquota or ccusage.
• You need token-level cost accounting → this only shows the percentage windows the vendors expose.
• You're on Linux → Brink is macOS and Windows only.

How Brink compares

CodexBar is the most complete macOS monitor; pick it if you want dozens of providers in the menu bar. Brink is for people who want nothing in the menu bar at all, and the same app on their Windows machine.

Project layout

windows/                      Brink for Windows (C# / WPF, .NET 8) — see windows/README.md
Package.swift                 Swift Package (macOS 13+)
build.sh                      build → .app + .