How does AgentPeek alert me when an agent needs permission?

AgentPeek opens permission requests inline. Keyboard shortcuts (Command-A allow, Command-N deny, Option-A always allow for Claude Code, Option-T open Terminal) keep the flow fast.

Claude and Codex in your
Mac notch and menu bar.

A small Mac app that keeps agent essentials visible while you work.

Download for Mac Free 2-day trial · macOS 14+ · Apple silicon

The essentials, always visible.

Tokens, servers, and routes, one glance away.

Token Usage

5-hour and 7-day limits at a glance. Never get rate-limit surprised mid-flow.

Server Management

Local dev servers, grouped by project. Open, copy, or stop in one click.

localhost:3000Next.js

marketing1h 12m

localhost:5173Vite

web3h 37m

localhost:8787Wrangler

api42m

localhost:4321Astro

docs2h 08m

localhost:9323Playwright

tests18m

localhost:6006Storybook

ui5h 45m

Quick Routes

Jump straight to a session's skills, plugins, config, or logs.

Skills .claude/skills

Plugins .claude/plugins

Config .claude/settings.json

Logs .claude/projects

Root .claude

Skills .codex/skills

Plugins .codex/plugins

Config .codex/config.toml

Logs .codex/sessions

Root .codex

Built for many sessions.

Track parallel Claude Code and Codex sessions from one place.

Unlimited Parallel Sessions

Run as many Claude Code and Codex sessions as your Mac can handle.

agentpeek-web·Editing src/auth/session.ts

74+47-12

2mGhostty

project-api·Planning request limits

42sequential-thinking

5miTerm

docs-site·Awaiting permission

1mTerminal

release-pipeline·Preparing release notes

4mWarp

admin-tools·Refactoring InteractionPanel

149+84-31filesystem

18mTerminal

marketing·Awaiting next prompt

2htmux

Tool Call History

Every tool call summarized, searchable, replayable per session.

Last reply

Added download helpers and 4 tests in lib/routes/.

Timeline

Touched download.ts· src/routes/download.ts3s

Ran command· npm test lib/routes9s

Touched download.spec.ts· tests/download.spec.ts16s

Read handlers.ts· src/routes/handlers.ts24s

Selected: exponential backoff31s

Question requested· retry strategy38s

Permission requested· run terminal command45s

Scoped search· createDownload52s

Touched download-service.ts· src/services/download-service.ts1m

Session started2m

Notch or menu bar

Run it in the notch, the menu bar, or both, on any Mac.

Notch

Menu bar

Answer your agent inline.

Questions, permissions, and plans stay close while you work.

Questions

Agent questions surface inline. Answer with a keystroke and stay in flow.

Question pending

How should Mission Control open?

1Gesture (swipe up, 3 fingers)

2Keyboard shortcut (⌘F3)

3Hot corner (top-right)

Where should new sessions dock?

1Follow the active display

2Always on the built-in screen

3Remember per Space

Skip Continue

Permissions

Allow, deny, or always-allow tool calls from the notch. ⌘A / ⌘N / ⌥A.

Permission requested

Edit auth/session.ts in project-api

- function createSession(userId: string) {

- const token = getToken();

- return { userId, token };

- }

+ async function createSession(

+ userId: string,

+ opts: SessionOptions = {},

+ ) {

+ const token = await getToken(opts.ttl);

+ const expiry = computeExpiry(opts);

+ await store.persist(userId, token, expiry);

+ metrics.record("session.create", userId);

+ return { userId, token, expiry };

+ }

Deny ⌘N Always Allow ⌥A Allow ⌘A

Plans

Read the agent's plan before it runs. Approve, edit, or send back.

Plan pending

Refactor routes.ts to isolate route helpers.
Add parser helper for redirect targets.
Wire the helper into middleware/routes.ts.
Update tests in tests/routes/ for the new shape.
Migrate two callers that still pass raw paths.
Run pnpm tsc and full test suite.
Update the API reference for SessionOptions.
Add a changelog entry for the change.

Reject ⌘N Approve ⌘A

The little things.

Small touches you'll find all over the app, right where you need them.

Copy as Markdown

Right-click a session to copy it as Markdown: reply, files, and timeline.

Jump to the terminal ⌥T

Click the app badge on any session to bring its terminal window forward.

Notifications

Banners when an agent needs permission, finishes, or nears a limit.

Size it to fit

Slim or wide, comfortable or compact, regular or bold. Tune it to taste.

External display compatible

Not just the built-in screen. The notch panel works on external monitors too.

Right-click actions

Copy a path, reveal it in Finder, refresh usage, or end a running session.

Auto-expand on attention

The notch opens itself the moment an agent needs your answer.

Launch at login

Launches with your Mac and waits quietly in the notch until you need it.

Buy once. Full access.

Free for 2 days, then $9 one-time per Mac.

Free Trial

2 days, full access

All features unlocked
Unlimited sessions

Download for free

License

one-time

One payment, full access

$9/Mac

Future updates included
Apple silicon Mac, macOS 14+

Get a license

Questions, answered.

AgentPeek is a native macOS app that puts Claude Code and Codex in the Mac notch and menu bar. It shows live sessions, permission prompts, 5-hour and 7-day token usage, and local dev servers. It is built for Apple silicon, runs locally, and ships as a one-time $9 license after a 2-day free trial.

AgentPeek installs lightweight hooks for the Claude Code and Codex CLIs the first time you launch the app. The hooks let AgentPeek read local session state as you work: active prompts, recent tool calls, diffs, pending permission requests, and reported usage. New CLI sessions pick up the hooks automatically.

AgentPeek supports Claude Code and Codex. Both run as CLI tools on your Mac, and AgentPeek watches their local session state from the notch or menu bar.

AgentPeek costs $9 once for one Apple silicon Mac, with future updates included. The 2-day free trial unlocks every feature and includes unlimited sessions.

AgentPeek is local-first. Session transcripts, diffs, prompts, and token usage stay on your Mac. There are no accounts, no analytics, and 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.

AgentPeek is agent-aware: it tracks Claude Code and Codex sessions, permission requests, reported token usage, and local dev servers by project. Notch mode keeps agent attention visible, and menu bar mode gives you the same monitoring surface.

Install AgentPeek, launch it once, and it installs hooks for new CLI sessions. Run claude or codex in any terminal. AgentPeek surfaces sessions as they start.

AgentPeek opens permission requests inline. Keyboard shortcuts (⌘A allow, ⌘N deny, ⌥A always allow for Claude Code, ⌥T open Terminal) keep the flow fast.

AgentPeek runs on Apple silicon Macs with macOS 14 Sonoma or newer. It is a native Swift app built for M-series chips.

All current features, unlimited sessions, and future updates. One payment unlocks AgentPeek on one Apple silicon Mac.

Get AgentPeek.

Free for two days. $9 one-time license.

Download for Mac

Claude and Codex in your Mac notch and menu bar.