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 | bashPaste 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.
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.
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.
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: 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.
Completions, context and usage warnings, approvals, merges and review requests. You choose sound and macOS banners for each.
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.
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.
Open notch · usage viewThe numbers come from Claude Code itself. When it doesn't report a limit, Overhead says so instead of guessing.
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.
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.
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.
Sessions under their Claude Code titles, questions and permissions you answer in place, agents, and your plan's usage.
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.
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.
A native Mac app. It lives in the notch, or below the menu bar on displays without one.
See every line Overhead adds before it writes anything. Your original is backed up, and Disconnect removes only Overhead's own entries.
$ claude
Start Claude Code the way you always do. Nothing about your workflow changes.
Every session's state, what it is doing, and a signal when it needs you.
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.
- 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.
- GitHub, if you enable it. Requests go to
api.github.comonly, 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