Real-time AI coding assistant telemetry in your Mac's notch
Features • Installation • Usage • Requirements
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.
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.
Track token usage (input/output) and estimated costs in real-time. Never be surprised by API bills again.
- 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.
Get notified when your AI assistant finishes a task. No more wondering "is it still thinking?"
- Lives in your Mac's notch — zero screen real estate used
- Native macOS app — fast, efficient, battery-friendly
- Expands on hover to show details
- Show/hide token counts
- Show/hide cost estimates
- Filter by source (Claude/Codex)
- Toggle menu bar icon
brew tap AppGram/tap
brew install --cask agentnotch- Download
AgentNotch-1.0.0.zipfrom Releases - Unzip and drag
AgentNotch.appto/Applications - Open AgentNotch
Add to your Claude Code configuration to send telemetry:
# Set OTEL endpoint to AgentNotch (default port 4318)
export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"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 (not [telemetry]). Add:
[analytics]
enabled = true
[otel]
# AgentNotch currently does not decode OTLP traces, so disable trace export to avoid noisy errors.
trace_exporter = "none"
[otel.exporter.otlp-http]
endpoint = "http://localhost:4318/v1/logs"
protocol = "binary"- Launch — AgentNotch appears in your notch (or menu bar on non-notch Macs)
- Hover — Expand to see recent tool calls with details
- Click — Open full view with token breakdown and settings
- Settings — Configure display options via the gear icon
| Collapsed | Expanded |
|---|---|
| Minimal notch indicator | Full tool call history |
- macOS 14.0 (Sonoma) or later
- Mac with notch (MacBook Pro 14"/16" 2021+) or any Mac (falls back to menu bar)
AgentNotch runs 100% locally. No data is sent anywhere — it only receives telemetry from your local AI tools.
MIT License — see LICENSE for details.
Made with ❤️ for developers who love AI coding assistants
