Act in place, in your notch

NotchDeck

Your MacBook notch becomes mission control for every AI agent you run. Glance at all parallel sessions, jump to the exact terminal pane, and decide right there in the notch — approve a tool, answer a question, sign off a plan. Claude Code and Codex today. Gemini, Aider, and more on the way.

Free & open source · no trial, no telemetry, no cloud

See it in action

This demo is playing itself — tap the stage to take over, then hit Resume demo anytime.

iTerm2ShellEditViewWindowHelp

Live demo · playing

3 active1.2M tok · $2.14

fix auth bug

ClaudeiTerm227m

backend server

CodexTerminal1h

optimize queries

GeminiGhostty5h

Permission

backend-serverCodexTerminal

Editsrc/auth/middleware.ts

const verify = (token) =>

- jwt.verify(token);

+ if (!token) throw new

AuthError('missing');

+ return jwt.verify(token);

+3−1

claude — fix-auth-bug

● Writing middleware.ts…

Searching for 6 patterns… (ctrl+o to expand)

codex — backend-server

● Needs permission · Edit middleware.ts

watching for changes · esc to interrupt

How it works

Hooks capture events

Claude Code hooks fire on session start, state change, and completion.

Bridge forwards to localhost

Bundled notch-bridge sends each event + ITERM_SESSION_ID to a local server.

Notch shows state, click jumps

The notch displays live status; clicking a session jumps to the exact pane.

No yabai. No cloud. No telemetry.

Act in place

Permission

fix-auth-bugClaudeiTerm2

Editsrc/auth/middleware.ts

const verify = (token) =>

- jwt.verify(token);

+ if (!token) throw new

AuthError('missing');

+ return jwt.verify(token);

+3−1

Ask

Claude asks

deploy-backendCodexWezTerm

Which deployment target?

Plan

Plan ready

refactor-authClaudeKitty

Add TokenService with refresh rotation

Move JWT secret into Keychain

Verify + refresh in middleware

Add /auth/refresh route + tests

+2 more steps

Option numbers are a visual index, not keyboard shortcuts.

Everything it does

Glanceable multi-session monitor

Track all parallel sessions with 5 live states at a glance.

Precise click-to-jump

Click any session row to jump directly to the exact pane.

Act-in-place decisions

Handle permissions, questions, and plan approval right from the notch.

Rich glance rows

Agent/terminal badges, activity, elapsed time per session.

Usage & cost tracking

Live token count and cost display (tokens + $ only).

Completion sounds

Glass, Basso, or Funk — toggleable audio notifications.

10 live themes

Switch themes instantly; the whole UI recolors in real time.

Multi-agent support

Claude ✓ · Codex ✓ · Gemini (planned) via AgentProvider seam.

Multi-terminal jump

iTerm2/WezTerm/Kitty get precise jump; others raise-to-front.

Self-configuring hooks

Auto-installs with settings backup; zero manual config.

Private & local-only

No cloud, no telemetry, no yabai. Everything stays on your Mac.

Hover-expand rows

Hover over session rows for expanded details and context.

Many agents, many terminals

The pluggable seams: an AgentAdapter per CLI, a TerminalJumper per app. Add one = implement + register.

fix auth bug

Writing middleware.ts…

ClaudeiTerm2

27m

backend server

Running tests…

CodexWezTerm

optimize queries

Done — click to jump

GeminiKitty

Agents

Claude CodeCodexGemini CLI

Terminals (jump-to-pane)

iTerm2WezTermKittyTerminal.appGhosttyWarptmuxVS Code

● solid = shipping precise-jump
◌ dashed = via the seam / raise-to-front

badge tint: Claude · Codex · Gemini

10 switchable themes

Click any card to recolor the whole page in real time. Syncs with the menu-bar switcher.

Beyond the glass

Same model, further reach. Sketches, not designs — furthest out on the roadmap.

SSH remote

later

Monitor sessions running on a remote box; the bridge posts over a tunnel. Jump opens the local terminal already SSH'd in.

train-model

epoch 3/10 · loss 0.42

prod-box ⇢ ssh

Mobile relay

later

Mirror the notch to your phone (Happy/Omnara pattern) — get the permission prompt and approve from anywhere.

deploy-preview

approve from anywhere

phone ⇢ relay

Cost & limits

exploring

The usage header, expanded: burn-down per window, projected reset, and server-truth rate limits (CCSeva OAuth), not just local token math.

✦ 5h

resets 4h01m

Support & Open Source

Free · MIT License

Everything in NotchDeck is 100% free and locally run

All features unlocked
Claude Code, Codex, Aider & Gemini
Act-in-place decisions in the notch
Cost tracking & 10+ themes
Session history & local-only logs
No telemetry · fully local

Apple Silicon · macOS 14+

Sponsor

Keep updates coming

Support

Help cover code-signing certificates and active engineering hours

Covers Apple Developer Program fees ($99/yr) for official codesigning
Offsets server, updating infrastructure, and API testing costs
Keeps NotchDeck completely independent of VCs, tracking, and Ads
Supports active maintenance to keep client terminal hooks stable

Buy me a coffee

One-time or variable contribution

Spread the word

Help us share NotchDeck

If you like the app, consider posting your experience on 𝕏 (Twitter) or GitHub to help more developers find it.

Share on 𝕏

NotchDeck is fully local, private, and open-source under the MIT license

Stay in the loop

Subscribe to get notified about new features, agent integrations, and releases. No spam. Only major updates.

NotchDeck is free and open-source. Sponsor our development on Buy Me a Coffee or view the codebase on GitHub

Put it in your notch.

Download the latest release, double-click to open, and NotchDeck auto-configures your agent hooks. No account. No cloud. Completely free.

Sponsor on Buy Me a Coffee

Apple Silicon · macOS 14+ · iTerm2 / WezTerm / Kitty · Claude Code · Codex

Right-click → Open on first launch (app is unsigned while in early access)