Repository navigation
Releases
Claude Overhead 1.0.3
- The notch's usage panel shows how much of each limit you have used, the same
number Claude Code's/usageshows, instead of how much is left. Bars fill
as a limit is spent, and a limit you have used up reads 100%.
Install
Paste this into Terminal:
curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bashIt downloads Claude-Overhead.dmg from the latest release, checks it against
SHA256SUMS.txt, installs Claude Overhead into Applications, and opens it.
Read install.sh
first if you like.
Requires macOS 14 or newer on an Apple silicon Mac.
Claude Overhead 1.0.2
- The closed notch's line of live activity under the camera can be turned off
in Settings → Notch Layouts → Show live activity in the closed notch.
It stays on by default. - Running GitHub workflows show a turning green ring instead of a blue dotted
circle, and running is green throughout GitHub Mode. Queued runs keep their
clock. - GitHub is checked every 30 seconds by default instead of every 5 minutes,
so a new pull request or run shows up in the notch within half a minute.
Choose a longer interval in GitHub → Integration; an interval you set
before carries over.
Install
Paste this into Terminal:
curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bashIt downloads Claude-Overhead.dmg from the latest release, checks it against
SHA256SUMS.txt, installs Claude Overhead into Applications, and opens it.
Read install.sh
first if you like.
Requires macOS 14 or newer on an Apple silicon Mac.
Claude Overhead 1.0.1
- Install from Terminal with one command, which checks the download's checksum
and needs no Gatekeeper approval:
curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bash - The usage panel shows per-model weekly limits, such as Fable, beside the
all-models limit, and warns when one crosses your threshold. - Plans without a 5-hour window no longer show an empty "5H —%" row.
- Weekly reset times parse even when Claude Code draws the panel without
spaces between words.
Install
Paste this into Terminal:
curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bashIt downloads Claude-Overhead.dmg from the latest release, checks it against
SHA256SUMS.txt, installs Claude Overhead into Applications, and opens it.
Read install.sh
first if you like.
Requires macOS 14 or newer on an Apple silicon Mac.
Claude Overhead 1.0.0
Claude Overhead's first public release: a notch companion for Claude Code.
Highlights
- Every Claude Code session in the MacBook notch: working, waiting for your
permission, asking a question, done, or failed. Sessions are ordered by what
needs you first, and stale work is never shown as running. - Live activity in Claude's own words. The closed notch shows the current tool
call, for exampleBash · Run tests and commit the logo change; click a
session in the open notch for its live feed of tool calls, each with its
command or file, time and outcome. - Answer Claude's questions and approve or deny its tool requests from the
notch. Nothing is ever approved silently, and if Claude Overhead is
unavailable the question goes back to the terminal. - GitHub Mode (⌃⌥G): pull requests, workflow runs, reviews and merging for the
repositories you choose, with one red or amber badge on the GitHub icon for
alerts you can dismiss. - A companion window with sessions, projects, agents, history, usage, GitHub
and settings; themes, five notch layouts, Focus mode and shortcuts.
Before you install
- Requires macOS 14 or newer on an Apple silicon Mac.
- Install it with the Terminal command in the README. This build is ad-hoc
signed, not notarized by Apple: the Terminal install opens without any
prompt, but a DMG downloaded in a browser needs Open Anyway in System
Settings > Privacy & Security on first launch. - Claude Overhead runs locally. It has no telemetry and sends your prompts,
transcripts and activity nowhere.
Install
Paste this into Terminal:
curl -fsSL https://github.com/rakeshkanneeswaran/claude-overhead/releases/latest/download/install.sh | bashIt downloads Claude-Overhead.dmg from the latest release, checks it against
SHA256SUMS.txt, installs Claude Overhead into Applications, and opens it.
Read install.sh
first if you like.
Requires macOS 14 or newer on an Apple silicon Mac.