Install AgentPeek

Download the signed DMG, drag AgentPeek.app to your Applications folder, and launch it once.

Download from agentpeek.app/download/latest.
On first launch, AgentPeek installs hooks for the Claude Code and Codex CLIs.
Open Settings → General → Agent hooks. Claude Code and Codex should show Ready. Toggle a hook off and on to reinstall it.

Run claude or codex in any terminal. New sessions appear in AgentPeek within seconds.

How does the AgentPeek pill and panel work?

AgentPeek lives in two states:

Pill: a compact bar inside the notch showing how many agents are active.
Panel: the expanded view for sessions, prompts, usage, and local servers.

Menu bar mode gives the same monitoring surface on Apple silicon Macs and external displays.

View Claude Code and Codex sessions

Each row in the panel is one live agent session. You see:

Agent (Claude Code or Codex) and project folder.
Status badge: executing, thinking, or waiting.
Most recent activity (file edited, command running, plan drafted).
Reported token usage, file/command tallies, host terminal, and elapsed time.

Click a row to view recent activity and diffs.

Handle Claude Code and Codex permissions

When Claude Code or Codex requests permission for a tool call, file edit, or command, AgentPeek opens the prompt inline. Keyboard actions stay close:

⌘ A: Allow once.
⌘ N: Deny.
⌥ A: Always allow (Claude Code).
⌥ T: Open Terminal for the session.

AgentPeek keeps permission prompts visible where you already watch the session.

Answer agent questions

When Claude Code or Codex asks a question, AgentPeek shows the prompt in the panel. Use number keys for choices, or send a custom reply when the agent asks for one.

Open Quick Routes

Quick Routes are per-agent shortcuts to the Claude Code and Codex folders developers open often:

Skills: the agent skill library.
Plugins: installed plugin files.
Config: Claude settings or Codex config.
Logs: recent agent session folders.
Root: the agent home folder.

AgentPeek opens each route in Finder or the preferred editor in one click.

Track token usage

AgentPeek reads token usage reported by Claude Code and Codex:

5-hour window: short-term usage, with reset time when reported.
7-day window: longer-term usage, with refill time when reported.

AgentPeek shows progress bars side by side so you can plan longer runs with live usage visible.

Manage local dev servers

AgentPeek watches ports 3000-9999 for active dev servers (Vite, Next.js, Wrangler, Astro, Playwright, etc.). Servers are grouped by project, matched via the listening process's working directory.

One click to open the URL in your browser.
One click to copy the URL or stop the process.

Settings & Notifications

From Settings you control:

Launch at login via macOS service registration.
Agent hooks: reinstall hooks per CLI.
Notifications for permission requests, token budgets, and completed runs.
Updates: check for new releases with Sparkle.

Pricing and licensing

Free for the first 2 days, with every feature unlocked. A one-time $9 license unlocks AgentPeek on one Apple silicon Mac, with future updates included.

One payment unlocks the full app.
Future updates are included.

Privacy

AgentPeek is local-first:

Session transcripts, diffs, prompts, and token usage stay on your Mac.
No accounts, no analytics, no telemetry.
Network activity is limited to license checks and Sparkle update checks.
License checks send the license key, machine ID, activation ID, and app version.

Support

Need help? Check the install and troubleshooting sections above, then update AgentPeek and retry.

AgentPeek docs.