AgentNotch

AgentNotch

  Real-time AI coding assistant telemetry in your Mac's notch

  Features •
  Installation •
  Usage •
  Requirements

What is AgentNotch?

AgentNotch is a sleek macOS menu bar app that lives in your Mac's notch, providing real-time visibility into your AI coding assistants. Watch as Claude Code and OpenAI Codex think, read files, and execute tools — all without leaving your editor.

Features

🎯 Real-Time Tool Tracking
See every tool call as it happens — file reads, code edits, shell commands, and more. Know exactly what your AI assistant is doing at any moment.

📊 Token & Cost Monitoring
Track token usage (input/output) and estimated costs in real-time. Never be surprised by API bills again.

🎨 Source-Aware Design
- Orange indicator for Claude Code
- Blue indicator for Codex
- Light blue for unknown sources

Visual distinction lets you know which AI is active at a glance.

🔔 Completion Detection
Get notified when your AI assistant finishes a task. No more wondering "is it still thinking?"

⚡ Lightweight & Native
- Lives in your Mac's notch — zero screen real estate used
- Native macOS app — fast, efficient, battery-friendly
- Expands on hover to show details

⚙️ Configurable
- Show/hide token counts
- Show/hide cost estimates
- Filter by source (Claude/Codex)
- Toggle menu bar icon

Installation

Homebrew (Recommended)

Manual Download

1. Download AgentNotch-1.0.0.zip from Releases
2. Unzip and drag AgentNotch.app to /Applications
3. Open AgentNotch

Usage

Setup with Claude Code

Add to your Claude Code configuration to send telemetry:

Setup with Codex

AgentNotch listens for OTLP/HTTP on port 4318 by default, and currently decodes OTLP logs (/v1/logs) and metrics (/v1/metrics).

Codex CLI (v0.79+) uses ~/.codex/config.toml with an [otel] section…