About Notchcode
Overview
Notchcode is an ambient monitor for Claude Code and OpenAI Codex CLI sessions. On macOS it draws an overlay that matches the MacBook hardware cutout exactly at rest and expands only when a session is live; on Windows it runs as a borderless, always-on-top status pill at the top-center of the primary monitor. It reports what your coding agents are doing without taking over the screen.
The project publishes signed and notarized macOS builds plus a per-user Windows installer that needs no admin rights. Version 1.0.0 shipped in June 2026 with both macOS and Windows builds, and version 1.1.0 added Codex CLI support. The repository is MIT licensed and its authors review issues and pull requests.
Key Benefits
- Track several Claude Code sessions at once through hooks, with a file watcher that keeps updates flowing when hooks are absent.
- Monitor OpenAI Codex CLI sessions through the same pipeline, with mixed sessions badged CC or CD so you always know which agent is running.
- Focus the right terminal with one tap on the notch whenever Claude waits on a permission prompt.
- Read live-tailed conversation history for any session without leaving the overlay.
- Count local tokens exactly and see a weekly budget with a quiet brake warning before you exceed it.
- Keep everything on your machine: no analytics, no telemetry, and no network calls beyond loopback.
How It Works
Notchcode reads the session files your agents already write, in ~/.claude/projects for Claude Code and ~/.codex/sessions for Codex, and listens for hook events on a local loopback server at 127.0.0.1:9876. Hooks deliver sub-second updates, while the file watcher keeps sessions visible without them. On first launch the app offers to install its Claude Code hooks, or you can run the provided install script manually, then tap the notch to drill into a session or jump to the waiting terminal.
Use Cases
- MacBook owners running long Claude Code sessions can see when the agent pauses for a permission prompt and jump straight to it.
- Developers running Claude Code and Codex CLI side by side track both agents in one overlay with clear CC and CD badges.
- MacBook Air, Mac mini, and external-display users get the same monitoring through a virtual notch at menubar center.
- Windows developers who prefer terminals get a top-center status pill instead of a menubar app.
- Token-conscious developers watch a weekly budget and receive a brake warning before spending past it.
- Release testers and contributors build from source in Xcode or run npm run tauri dev against the Windows workspace.
Why Choose This Product
Notchcode stays local by design: it reads files on disk and takes loopback traffic, and hooks are fire-and-forget so an agent never stalls when the app is closed. The hook installer is additive and idempotent, so it leaves other tools' hooks untouched, and the MIT license lets teams read, fork, and modify the source. One overlay covers both macOS and Windows machines.
Notchcode Pros & Cons
- Ships signed and notarized macOS DMG plus a per-user Windows installer
- Runs entirely local with no telemetry or network calls beyond loopback
- Hooks give sub-second updates with a file-watcher fallback
- Works on non-notch Macs via a virtual notch at menubar center
- MIT licensed with public source and reviewed PRs
- Requires Claude Code and/or Codex CLI installed to be useful
- SmartScreen may warn on first Windows launch while reputation builds
- Needs macOS 13+ or Windows 10 1809+/Windows 11
Key Features
Notch Overlay
At rest the overlay matches the hardware cutout exactly and expands only when a session is live.
Live Session Monitoring
Tracks multiple Claude Code sessions in real time via hooks, with a file-watcher fallback when hooks are missing.
Codex CLI Support
Monitors OpenAI Codex CLI sessions through the same pipeline and badges mixed sessions CC or CD.
Jump To Terminal
One tap on the notch focuses the correct terminal when Claude is waiting on a permission prompt.
Session Drill-Down
Tap a session to read its conversation history, live-tailed as it streams.
Token Budget Tracking
Shows exact local token counts with a weekly budget and a quiet brake warning before you hit it.
Session Lifecycle
End sessions gracefully from the notch while crashed sessions are detected automatically.
Auto Hook Setup
An additive, idempotent installer adds Claude Code hooks without touching other tools' hooks.
Windows Status Pill
A borderless, always-on-top pill sits at top-center of the primary monitor on Windows 10 and 11, built with Tauri 2.
Local-Only Privacy
Data stays on your machine with no analytics, no telemetry, and no network calls beyond loopback.
Frequently asked questions about Notchcode
What is Notchcode?
Notchcode is an ambient monitor for Claude Code and OpenAI Codex CLI that lives in the MacBook notch, and on Windows appears as a top-center status pill. It shows live session activity, conversation history, and token usage without taking over the screen.
Which platforms and versions does Notchcode support?
It requires macOS 13 or newer, or Windows 10 (1809+) or Windows 11, and needs Claude Code and/or Codex CLI installed. Notchcode also works on Macs without a notch by rendering a virtual notch at menubar center on Airs, minis, and external displays.
Does Notchcode send my data anywhere?
No. Everything stays on your machine: the project states there are no analytics, no telemetry, and no network calls beyond loopback.
Do I have to set up hooks manually?
On first launch Notchcode offers to install its Claude Code hooks for you. You can also run the provided install-hooks.sh script manually, adding the codex argument for Codex support.
What happens if Notchcode is not running when a hook fires?
Hooks are fire-and-forget, so they time out in under a second and the agent never notices. The file watcher keeps session data working even without hooks.
How does Notchcode collect session data?
It watches the session files your agents already write, in ~/.claude/projects for Claude Code and ~/.codex/sessions for Codex, and listens for hook events on a local loopback server at 127.0.0.1:9876.
