NotchDeck

Your MacBook notch, reimagined as an AI agent command deck.

Monitor multiple AI coding agents at a glance — click to jump to any session instantly.

---

✨ What is NotchDeck?

NotchDeck is a native macOS app that turns the MacBook Pro notch into a live status dashboard for your AI coding agent sessions.

Running 4 parallel Claude Code sessions? Spinning up a Codex CLI job while Claude edits tests? NotchDeck shows every session's state — working, needs input, needs permission, done, failed — right in the notch. One click jumps you to the exact terminal pane. No yabai, no cloud, no telemetry.

---

🚀 Features

• 🎯 Glanceable status — color-coded dots for every live agent session, always visible in the notch
• ⚡ Click-to-jump — focus the exact iTerm2 / WezTerm / Kitty pane in one click
• 🤖 Multi-agent — supports Claude Code and Codex CLI today; more agents coming
• 💻 Multi-terminal — iTerm2, WezTerm, Kitty, and any terminal as fallback
• 💰 Cost tracking — live token usage and estimated spend per session
• 🔔 Completion sound — subtle chime when a session finishes
• 🎨 Themes — dark, light, minimal, vibrant glassmorphism
• 🔒 100% local — no accounts, no cloud, no telemetry; HTTP server binds to 127.0.0.1 only
• ⚙️ Self-configuring — auto-installs agent hooks on first launch

---

📸 Screenshots

Multi-Session Command Deck (Expanded notch view)

In-Notch Decision Workflows

📋 Action/Task Plans Gate

Inspect progress and approve execution plans directly from your MacBook notch.

❓ Prompt Questions & Clarifications Gate

Clarify details or select configuration details from options with single/multi-choice selects.

🔒 Permission Gate

Approve, deny, or grant temporary access for file changes and tool usage with interactive color-coded diff overlays.

---

🤖 Supported Agents

Agent	Status	Cost Tracking
Claude Code (Anthropic)	✅ Supported	✅
Codex CLI (OpenAI)	✅ Supported	✅
Gemini CLI (Google)	🔜 Planned	—
Aider	🔜 Planned	—
Custom agents	Via HTTP API	—

---

💻 Supported Terminals

Terminal	Jump Precision	Status
iTerm2	Exact window → tab → pane	✅
WezTerm	Exact pane	✅
Kitty	Exact window	✅
Terminal.app / Ghostty / others	App raise	✅ (fallback)

---

📦 Getting Started

Requirements

• Apple Silicon Mac (M1 or later)
• macOS 14 Sonoma or later
• At least one supported AI agent installed

Install

Option A — Homebrew Cask (Recommended)

brew install navjotdhanawat/notchdeck/notchdeck

(Or tap first: brew tap navjotdhanawat/notchdeck && brew install notchdeck)

Option B — Terminal One-Liner (curl)

curl -fsSL https://notchdeck.app/api/install | bash

Or via GitHub raw:

curl -fsSL https://raw.githubusercontent.com/navjotdhanawat/notchdeck/main/install.sh | bash

Option C — Download DMG

1. Download NotchDeck.dmg from the Releases page or notchdeck.app
2. Open the .dmg and drag NotchDeck.app to /Applications
3. Launch NotchDeck

macOS Gatekeeper note: NotchDeck is not yet signed with an Apple Developer certificate, so macOS will block DMG/ad-hoc installations on first launch with "NotchDeck can't be opened because it is from an unidentified developer."

To open it anyway:

1. In Finder, right-click (or Control-click) NotchDeck.app → Open
2. Click Open in the dialog that appears

You only need to do this once. After that, it launches normally. Alternatively: System Settings → Privacy & Security → scroll down → click "Open Anyway"

Option D — Build from source

git clone https://github.com/navjotdhanawat/notchdeck.git
cd notchdeck
swift build -c release

First Run

1. Launch NotchDeck — it appears in your MacBook notch
2. NotchDeck auto-detects installed agents and configures hooks
3. Start a new AI agent session in your terminal
4. Watch it appear in the notch instantly 🎉

See docs/getting-started.md for the full setup guide.

---

⚙️ How It Works

AI Agent Hook  →  notch-bridge  →  localhost HTTP  →  NotchDeck  →  Notch UI
   (fires)         (tiny CLI)        (:7779)          (Swift app)   (DynamicNotchKit)

• Agent hooks fire notch-bridge on every session event
• notch-bridge enriches the event with terminal env vars and POSTs to the app
• NotchDeck updates the notch in real time — no polling, pure event-driven

See docs/architecture.md for the full technical breakdown.

---

🗺️ Roadmap

v1 — Core (current — open source, free)

• Claude Code support
• Codex CLI support
• iTerm2, WezTerm, Kitty jump support
• Cost & token tracking
• Themes (3 included free)

v2 — Act in Place (planned · Pro)

• Approve / deny permissions directly from the notch — no terminal switch
• Answer prompts inline
• Remembered decisions per project

v3 & Beyond (planned · Pro)

• Gemini CLI, Aider, Cursor agents
• Ghostty precise jump
• SSH remote session relay
• Session history & replay
• Mobile companion app

---

💎 Free vs Pro

NotchDeck's core is open source and free forever (MIT). Pro unlocks power-user features once they ship.

Feature	Free	Pro
Agent sessions	Up to 3	Unlimited
Claude Code & Codex CLI	✅	✅
Click-to-jump terminal focus	✅	✅
Cost & token tracking	✅	✅
Themes	3	All (+ custom)
Act-in-place decisions	—	✅ (v2)
Session history	—	✅ (v3)
Priority support	—	✅

Pro pricing: $9/month · $79/year — join the waitlist to get notified at launch.

---

🤝 Contributing

Contributions are very welcome! The most impactful areas:

• 🤖 New agent adapters — implement AgentProvider for your favorite agent
• 💻 New terminal adapters — implement TerminalIdentifying + TerminalJumping
• 🐛 Bug reports — open an issue with reproduction steps

See docs/contributing.md for the full guide.

---

📄 License

MIT © Navjot Dhanawat

---

_{Built with ❤️ for developers who run too many agents at once.}