Introducing AgentPeek

AgentPeek is a macOS app that lives in your notch and keeps every Claude Code and Codex session one glance away. No window to dig for, no terminal to hunt through — the work your agents are doing is always visible at the top of your screen.

Why it exists

Running AI coding agents is a juggling act. You start Claude on one project, Codex on another, maybe a background refactor in a third, and suddenly you’re flipping between windows to see who’s blocked, who’s asking for permission, and who’s burning through tokens. Important signals get buried. Approvals stall for minutes because you didn’t notice the prompt.

The notch is the most valuable pixel real estate on a Mac — always on top, never in the way. AgentPeek puts your agents there.

What AgentPeek does

Live session cards in the notch. Hover the notch and every running Claude Code and Codex session fans out. You see what each one is working on, the latest message, and whether it’s waiting on you.

One-tap permission approvals. When an agent asks to run a command, edit a file, or touch the network, the prompt surfaces right in the notch. Approve, deny, or allow-for-session without leaving whatever you were doing.

Usage, always visible. A global tracker shows your 5-hour and 7-day token windows for Claude Code and Codex, side by side. Know how close you are to a limit before an agent hits one.

Quick Routes. Pin the folders you work in most. One click jumps you straight into a Claude or Codex session there, with the right CWD already set.

Local servers in one place. Your npm run dev, vite, next dev, and friends show up in a single panel with their ports, projects, and live state. Open in browser, copy the URL, or stop the process from the notch.

Jump to the terminal. Click a session card and AgentPeek focuses the exact terminal window running that agent — Ghostty, iTerm, Terminal.app, Warp, or whatever you use.

How it works

AgentPeek installs lightweight hooks into Claude Code (~/.claude/settings.json) and Codex (~/.codex/hooks.json) the first time you launch it. The hooks stream events to the app over a local socket — nothing leaves your machine, and nothing touches your sessions’ output.

You can toggle the hooks off any time in Settings → General → Agent hooks. Uninstalling the app removes them cleanly.

Grab the download and try it free for two days. Lifetime access is a single payment — no subscription, no seat count.

AgentPeek is built and maintained by one person. If something breaks or you have an idea, send me a message on X!