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…
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
⚠ Unverified source (community-unclaimed, low activity) — reveal the prompt
⚠ Unverified source (community-unclaimed, low activity). Inspect the repo before letting your agent install it. Install and set up agentnotch (release-binary project) into my current project. Found on https://claudeers.com/agentnotch Repo: https://github.com/AppGram/agentnotch Homepage/docs: — Detected install method: release-binary → inspect the README Category: devtools. Platforms: cli, api. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: dormant; community-verified: false. Confirm the source before running anything.
Grab the latest release asset from GitHub.
# download a build from https://github.com/AppGram/agentnotch/releases
git clone https://github.com/AppGram/agentnotch
// compatibility
| Platforms | cli, api |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | — |
| Pricing | open-source |
| Language | Swift |
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)
brew tap AppGram/tap
brew install --cask agentnotch
Manual Download
- Download
AgentNotch-1.0.0.zipfrom Releases - Unzip and drag
AgentNotch.appto/Applications - Open AgentNotch
Usage
Setup with Claude Code
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"
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 (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"
Using the App
- 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
Screenshots
| Collapsed | Expanded |
|---|---|
| Minimal notch indicator | Full tool call history |
Requirements
- macOS 14.0 (Sonoma) or later
- Mac with notch (MacBook Pro 14"/16" 2021+) or any Mac (falls back to menu bar)
Privacy
AgentNotch runs 100% locally. No data is sent anywhere — it only receives telemetry from your local AI tools.
License
MIT License — see LICENSE for details.
Made with ❤️ for developers who love AI coding assistants
// faq
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.. It is open-source on GitHub.
Is agentnotch free to use?
agentnotch is open-source, so it is free to use.
What category does agentnotch belong to?
agentnotch is listed under other in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/agentnotch)
// retro hit counter
[](https://claudeers.com/agentnotch)
// reviews
// guestbook
// related in Developer Tools
🔓The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
🔓Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA
🔓AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
🔓Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.