CrewNotch · Every AI coding agent, live in your notch

Stop checking every terminal.

You run Claude Code in one window, Codex in another, Cursor on the side. One finished ten minutes ago. Another has been waiting on you the whole time. CrewNotch tells you, quietly, right where you're already looking.

Status at a glance

The closed notch shows the agent that matters most right now: working, finished or waiting on you.

Approve from the notch

Allow, deny or always allow Claude Code, Codex and OpenCode requests with the whole command or diff in view. Risky ones get a warning.

Questions, answered

When Claude Code asks you to choose, pick an option or type an answer right in the notch.

Keyboard first

Open the notch from anywhere with one shortcut, then allow, deny or answer without touching the mouse.

A gentle “finished”

When a turn ends while you're elsewhere, the notch drops down for a moment with a soft sound of your choice.

Back in one click

Jump to the right Ghostty, Terminal or iTerm2 tab, tmux pane or app window, straight from the session.

Plan usage, built in

Session and weekly limits for Claude, Codex, Antigravity, Cursor, Copilot and more, with a heads-up when one runs low or resets.

Token history

Tokens per day across agents, your busiest day and the API value of your usage. Share it as an image.

Keep Awake

Agents keep going when the display sleeps or the screen locks, with battery and time limits so nothing runs away.

Reply, resume, run

Type a reply to the agent's terminal, resume a finished session, or watch any long command with crewnotch run.

Away from your desk

Get a Mac notification or a push on your phone when an agent needs you, only while you're away if you like.

Speaks your language

English, 简体中文, हिन्दी, Español, Français, العربية, Português, Русский, 日本語 and Türkçe.

Set up in a minute.

No account, no config files to edit by hand.

Open CrewNotch

It finds the agents installed on your Mac and lists them in a short setup.

Connect your agents

One click per agent adds a tiny hook. CrewNotch only touches its own entries, and nothing is installed without your click.

Get back to work

The notch keeps watch. Hover to see every session, click to jump in, or approve right there.

Ten agents, one notch.

Hooks for the CLIs and IDEs, a small plugin for OpenCode, and session logs for DeepSeek Harness.

AgentHow it connectsStatusApproveUsage

Claude CodeHooks in ~/.claude/settings.json

CodexHooks in ~/.codex/hooks.json

CursorHooks in ~/.cursor/hooks.json

Gemini CLIHooks in ~/.gemini/settings.json

AntigravityA named hook in ~/.gemini/config/hooks.json

DeepSeek HarnessReads its session logs, nothing installed

OpenCodeA small plugin in ~/.config/opencode/plugin/

Copilot CLIIts own file in ~/.copilot/hooks/

GrokIts own file in ~/.grok/hooks/

KiroIts own file in ~/.kiro/hooks/

Agents without notch approval still show when they need you, with an Open button that takes you straight there. OpenCode usage covers OpenCode Go.

Private by design.

CrewNotch is a local app. It watches your agents through hooks and log files on your Mac, and talks to them over a socket only your user can open.

No account, no analytics. Nothing about your work is collected or sent anywhere.
Observe-only hooks. If CrewNotch isn't running, the hook exits quietly and your agent carries on as usual.
Usage is opt-in, per provider. Each one says exactly what it reads. Sign-ins are never refreshed, written or stored.
Notifications are yours. Phone pushes are off until you set them up, and name only the agent unless you allow more. The notch can hide itself from screen sharing.
Open source. Every line is on GitHub under Apache 2.0.

Get CrewNotch.

Download the app, drag it to Applications and open it. It takes a minute.

Download

Version 1.4.0 for macOS 15.6 or later, universal for Apple silicon and Intel. Signed and notarized by Apple, and it keeps itself up to date.

Download CrewNotch.dmg All releases

Build from source

Prefer to build it yourself? Clone the repo and build with Xcode 26 or later.

git clone https://github.com/karabogadev/crewnotch.git
cd crewnotch
xcodebuild -scheme CrewNotch -configuration Release build

macOS 15.6+MacBook with a notch, or any displayXcode 26+

Questions

Does it work without a notch?

Yes. On Macs and displays without a notch, CrewNotch draws the same island at the top center of the screen. You can pick which display shows it in Settings → General.

Will it slow down or change my agents?

No. Hooks only report what's happening. They never change an agent's behavior, apart from an approval or answer you give from the notch, and they exit right away if CrewNotch isn't running.

Codex doesn't show up.

Codex asks you to review new hooks the next time it starts. Choose Trust all and continue.

Antigravity or OpenCode doesn't show up.

Both load hooks and plugins at startup. Quit and reopen the app after connecting it.

Kiro doesn't show up.

Kiro only runs global hooks with its v3 engine. Start it with kiro-cli chat --v3.

How do I uninstall it?

Open Settings → Agents and press Disconnect for each agent, which removes CrewNotch's hooks and plugin files. Then quit CrewNotch, move it to the Trash and delete ~/.crewnotch.

Your whole AI crew, in the notch

See it in eight seconds.