A notch companion for Claude Code on macOS

Claude Code.
Always in view.

Your Claude Code sessions, questions, permissions and agents, live in your Mac's notch.

curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bash
Explore the experience

Paste into Terminal · macOS 14 or newer on Apple silicon · Free and open source (GPL-3.0) · Read the script · An independent project, not affiliated with Anthropic

Interactive simulation with example data · pick a state, or click inside the notch

4 sessions

Every session.
One glance.

Run Claude in four terminals and the notch keeps track of all of them: which are working, which are waiting on you, and which are done. Each row carries the title Claude Code gives the session. Step through them from the keyboard and jump straight to the terminal tab or editor window a session runs in.

Live state for each session

Working, waiting for permission, asking a question, done or failed, plus what it is doing right now: reading files, running a command, delegating to agents. Branch and context stay in the companion window.

Jumps to the right place

Focuses the exact Terminal or iTerm tab, or the VS Code, Cursor or Windsurf window. macOS asks once before Overhead can switch Terminal or iTerm tabs.

Picks up where you left off

Each finished session stays in local history. Resume it with claude --resume in one click.

Waiting for permission

Never miss the moment
that matters.

When Claude needs a decision, the notch opens with the full request. Approve a command or answer a question right there, then carry on. Try both.

Claude is blocked until you decide.
Pick an answer, or choose Other and type your own.
Critical

Claude is blocked: a permission request, a question or a failure. Always shown, even in Focus mode or quiet hours. GitHub failures are critical too, but only Claude's requests open the notch.

Informational

Completions, context and usage warnings, approvals, merges and review requests. You choose sound and macOS banners for each.

Ambient

A session started, or Claude moved on to the next step. Quietly visible, never interrupting.

Every decision is yours. Overhead offers Deny, Allow Once and Allow All for this session. It never offers bypass mode and never approves anything on its own. If Overhead is closed or something goes wrong, Claude Code asks in the terminal as usual, and a failure never counts as an approval.

Delegating to agents

One Claude.
A whole team of agents.

When Claude hands work to subagents, the notch gives each one a row: what it was asked to do, whether it runs in the background, how long it has been going, and whether it finished or failed. The map beside it shows who delegated what.

Agent ViewWorkingFinishedFailedbgBackground

Context 82%

Know where you stand.

Two numbers decide how far Claude can go: how full this conversation's context is, and how much of your plan you've used. The notch keeps both in view, and warns you once when you cross a line you set.

Closed notch · Expanded layout
82% of 200K

Open notch · usage viewThe numbers come from Claude Code itself. When it doesn't report a limit, Overhead says so instead of guessing.

Context is per conversation.That's the ring in the closed notch. A fresh session starts near zero, and context drops again when Claude Code compacts the conversation.
Usage is per account.That's the meter in the open notch's band. Every session you run adds to the same 5-hour and weekly windows until they reset.

Done in 18m 42s

Know what Claude actually accomplished.

Every session gets a receipt: what you asked, the branch, every file changed with git's own line counts, the commits made in that window, the tests that ran, the pull request and the cost Claude Code reported.

Receipts live in your local history, searchable by prompt, reply and file. Copy one into a pull request or a standup note.

Session receipt · exampleCompleted

Add per-key rate limiting to the gateway

api-gateway · feat/rate-limits · Opus 5.5

StartedSun 14:02
Duration18m 42s

Files changed

Commits2
3f9c2a1Add a token bucket per API key
8b07d4eCover burst and refill in tests

npm test -- rateLimitpassed
npm testpassed

Pull request#142 · checks passing
Reported cost$1.86

From git, read on your Mac. Overhead asks before reading a repository in Documents, Desktop or iCloud Drive.

Checks passed on #142

From first prompt to merged pull request.

Click the GitHub mark in the notch and it switches to GitHub Mode: the repositories you pick, across every organization you're in, with their workflow runs, pull requests and reviews. When GitHub says a pull request can merge, you can merge it right there. Click through it below.

GitHub is off until you turn it on. Overhead signs in with the GitHub CLI you already use, or with a token you paste, which it keeps in your Keychain. Its only write to GitHub is a merge you confirm. github.com for now.

One companion

One notch. Two modes.

Claude Mode tells you what Claude is doing. GitHub Mode tells you what's happening to your code after it reaches GitHub. It's the same notch, one click apart. There's no second app and no dashboard to open.

Claude Mode

Sessions under their Claude Code titles, questions and permissions you answer in place, agents, and your plan's usage.

GitHub Mode

The repositories you pick: workflow runs, pull requests, reviews, and a merge when GitHub says it's ready.

Click the GitHub mark in the notch, or ‹ Claude to come back

Settings

Make Overhead yours.

Five notch layouts, six themes, seven accents, GitHub Mode, and control over every sound and banner. Change something below and the notch above it changes too.

The open notch with these choices. Each layout card shows its closed notch.
Notch Layouts

Setup

Keep working the way you work.

Overhead sits next to Claude Code. You keep your terminal, your editor and your habits. It shows you exactly what it adds before it changes anything.

1Install Claude Overhead

A native Mac app. It lives in the notch, or below the menu bar on displays without one.

~/.claude/settings.json + "hooks": { …overhead… } backup: settings.json.overhead-backup
2Connect Claude Code

See every line Overhead adds before it writes anything. Your original is backed up, and Disconnect removes only Overhead's own entries.

~/code/api-gateway
$ claude
3Keep using your terminal

Start Claude Code the way you always do. Nothing about your workflow changes.

4Watch the notch

Every session's state, what it is doing, and a signal when it needs you.

5Step in when Claude asks

Approve, deny or answer from the notch. If Overhead isn't running, Claude Code asks in the terminal as usual.

Local first

Your sessions stay on your Mac.

No account to create, no telemetry, no analytics. Here is exactly what stays and what leaves.

Stays on your Mac
  • Session history. One summary per session in ~/Library/Application Support/Overhead, readable only by you. Kept 90 days by default; export or delete it any time.
  • Your last prompt and Claude's last reply, capped at 2,000 characters, so you can search them. On by default, and one switch turns it off.
  • Questions and permission details exist only in memory while Claude waits. Claude Code's own transcripts are never copied or changed.
Leaves your Mac, only when you turn it on
  • GitHub, if you enable it. Requests go to api.github.com only, for the repositories you pick. The one thing Overhead writes is a merge you confirm. Sign-in borrows the GitHub CLI's token, or uses a token you paste, stored in the macOS Keychain and never logged.
  • Usage numbers come from Claude Code, which talks to Anthropic as it always does. Overhead never reads your Claude credentials.
  • No Accessibility or Screen Recording permission. macOS asks once before Overhead switches Terminal or iTerm tabs, and before it reads a project in Documents, Desktop or iCloud Drive.

Give Claude a place
on your Mac.

Claude Code, right where you need it. Free, open source, and built natively for macOS.

curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bash
Replay the demo
One command

Install Claude Overhead

curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bash
  1. Paste it into Terminal and press Return.
  2. It downloads the latest release, checks it against the release’s checksums, installs Claude Overhead into Applications and opens it. Run it again any time to update.
  3. Follow the setup window to connect Claude Code. It shows exactly what it adds to ~/.claude/settings.json and keeps a backup.

macOS 14 or newer on Apple silicon. Want to see what it runs first? Read install.sh. Prefer to build it yourself? The README has the two commands.