Notchcode

Product Introduction

1. Definition: Notchcode is a cross-platform desktop application and developer utility that functions as an ambient monitor for AI coding agents. Specifically, it transforms the MacBook's hardware notch and, on Windows, a virtual top-center pill into a real-time status interface for managing sessions of AI-powered coding tools like Claude Code and OpenAI Codex CLI.
2. Core Value Proposition: Notchcode exists to solve the multi-session management and attention fragmentation problem inherent in modern AI-assisted development. Its primary value is providing at-a-glance, low-distraction visibility into the status of multiple concurrent AI agent sessions, enabling developers to stop losing track of background processes and quickly focus the right terminal when an agent requires input.

Main Features

1. Ambient Notch UI & Status Monitoring: The core feature leverages the physical or virtual notch/pill as an ambient status display. At rest, the overlay matches the hardware cutout exactly. It expands and glows (e.g., amber) only when an active AI coding session requires attention, such as a permission prompt. This is achieved through a hybrid monitoring system: it uses session hooks (installed via an idempotent script) for sub-second event updates, with a file-watcher fallback monitoring standard agent directories (~/.claude/projects/ for Claude Code, ~/.codex/sessions/ for Codex) for robustness.
2. Multi-Agent Session Management & Jump-to-Terminal: Notchcode tracks multiple concurrent Claude Code and Codex CLI sessions in real-time. Sessions are displayed within the notch interface and badged as "CC" or "CD" to distinguish between agent types. A key interaction is the "Jump to Terminal" feature: one tap on the glowing notch automatically focuses the correct terminal window where the specific agent session is running, solving the problem of identifying and switching between numerous terminal windows.
3. Local Usage Tracking & Session Control: The application provides local, private analytics on agent usage. It calculates exact token counts per session and aggregates them into a weekly usage budget, providing a quiet "brake" warning before usage thresholds are hit. Users can also gracefully end sessions directly from the notch interface, and the tool automatically detects and flags crashed sessions.

Problems Solved

1. Pain Point: The primary pain point is attention fragmentation and session overload during AI-assisted development. Developers running multiple AI agents (like Claude Code and Codex) simultaneously in different terminals face challenges: losing track of which session needs input, wasting time manually searching for and focusing the correct terminal, and having no immediate visibility into overall agent usage or budget.
2. Target Audience: The target audience is software developers, DevOps engineers, and power users actively using AI coding assistants such as Claude Code and OpenAI Codex CLI. This includes individual contributors, teams in agile environments, and particularly developers who manage multiple parallel coding tasks or debugging sessions using different AI agents.
3. Use Cases: Essential scenarios include: 1) Debugging an application where multiple AI agents are handling different modules or tests, and one needs a quick permission grant. 2) A developer running a long-term Codex CLI refactoring task alongside interactive Claude Code debugging sessions, needing to monitor both without context switching. 3) Monitoring weekly AI coding agent token consumption against a personal or team budget to avoid unexpected costs or throttling. 4) Quickly resuming work after context switching by using the ambient notch to identify which agent has been waiting.

Unique Advantages

1. Differentiation: Unlike traditional terminal multiplexers or IDE integrations, Notchcode operates as a system-level ambient monitor independent of the coding environment. It differentiates from simple terminal tabs or process lists by providing context-aware, hardware-integrated visual cues (the notch glow) that demand minimal attention until actively needed. It also differs from potential cloud-based dashboards by being fully local and privacy-focused.
2. Key Innovation: The key innovation is the novel use of hardware UI elements (notch/virtual pill) as an active, bidirectional control interface for software processes. It repurposes a previously passive design element into a dynamic status indicator and control point. Technically, its hybrid monitoring approach (combining fast hooks with reliable file-watching) and its non-invasive, additive hook installer that avoids conflicts with other tools represent significant practical innovations for developer tooling.

Frequently Asked Questions (FAQ)

1. What are the system requirements for Notchcode? Notchcode requires macOS 13+ or Windows 10 (version 1809+) / Windows 11. It also requires the installation of either Claude Code and/or OpenAI Codex CLI on your system to monitor their sessions.
2. How does Notchcode handle privacy and data security? Notchcode is designed with a strict local-only privacy model. All processing happens on your machine. It makes no telemetry calls, collects no analytics, and all network communication is limited to loopback (127.0.0.1:9876) for its own internal hook communication. No session data ever leaves your computer.
3. Does Notchcode work with other AI coding tools besides Claude Code and Codex? Currently, Notchcode is specifically built and optimized to monitor Claude Code and OpenAI Codex CLI sessions. Support for other AI coding agents would require monitoring their specific session file formats or hook systems.
4. Can I customize the appearance of the notch display on macOS? While the core ambient monitoring function is consistent, the roadmap includes planned features for themes and customization, including accent colors and community-driven prebuilt themes. The current version focuses on functionality that integrates seamlessly with the default system appearance.
5. How does the "one tap focuses the right terminal" feature work across applications? When a session needs input, Notchcode detects this via hooks or file changes. The notch UI expands, and tapping the relevant session item uses OS-level commands to identify and bring the terminal window running that specific Claude Code or Codex CLI process to the foreground, saving you from manual searching.