# AgentKnocks for Mac

Canonical page: https://macbase.app/apps/agentknocks

> Know which Claude Code or Codex session needs you

- Price: Free, with paid features
- Requires: macOS 14 Sonoma or later
- Languages: English
- Apple silicon: runs natively
- Notarized by Apple: yes
- Verified on MacBase: yes
- Developer: Sidhant Sinha
- Categories: [Developer Tools](https://macbase.app/categories/developer-tools), [Coding Agents](https://macbase.app/categories/coding-agents), [Menu Bar & Notch](https://macbase.app/categories/menu-bar-notch)

## Deal for MacBase members

25% off, until 2026-12-31. The code is on the MacBase page for anyone signed in with a free account.

## About

AgentKnocks is a Mac menu-bar app for people who run several Claude Code or Codex sessions at once. When an agent stops for your approval, finishes a turn or fails, it knocks: one notification that names the agent, the project and the reason, like "api-server — waiting for approval to use Bash."

It works in any terminal or editor, because the agents report in themselves through their documented hooks. It never reads your prompts or code: a few facts about each event stay in a folder on your Mac, and nothing about your agents is ever sent anywhere.

What it does:
• One list for every session: Working, Needs Attention, Completed, Failed, Interrupted or Stale, in the menu bar and the Sessions window.
• Notifications that say why: permission requests, finished turns and failures, each naming the agent, the project and the reason. Repeats are filtered, with pause and quiet hours built in.
• The Island: an optional black panel around the notch (or a pill on Macs without one) showing how many agents are waiting. Hover to see every session; click a row to bring it up.
• Next waiting agent: press ⌃⌥K from any app to go to the agent that has waited longest.
• Jump to the terminal (Pro): click a notification to bring up that session's tab in Terminal, iTerm2 or Ghostty, or its terminal in VS Code or Cursor with the free companion extension.
• Codex CLI (Pro), alongside Claude Code.
• Reminders (Pro) when an agent keeps waiting, and history up to 90 days.
• Setup you can read: it shows the exact hook entries it will add to ~/.claude/settings.json or ~/.codex/hooks.json, backs the file up first, and leaves your own hooks alone. Uninstalling removes only its own entries.
• Only watches: it never approves or denies anything, and its helper takes about 5 ms per event.

Works with Claude Code and Codex CLI, in Terminal, iTerm2, Ghostty, Warp, tmux, VS Code and Cursor.

Made for developers who run several AI coding agents at once and keep losing time to a permission prompt sitting in a background tab.

Native Mac app, universal (Apple silicon and Intel), signed and notarized by Apple. Free for Claude Code; Pro is a one-time purchase.

## An alternative to

- [Claude Code](https://macbase.app/alternatives/claude-code): 2 alternatives on MacBase
- [OpenAI Codex](https://macbase.app/alternatives/openai-codex): 3 alternatives on MacBase

## Get it

- Download: https://agentknocks.com/download/AgentKnocks.dmg
- Website: https://agentknocks.com

Listed by [Sidhant Sinha](https://macbase.app/@hisidhant).

## Similar Developer Tools apps

- [Vitals](https://macbase.app/apps/vitals): See which app is slowing your Mac ($9, 10% off for MacBase for MacBase members, System Monitoring, Apple silicon, macOS 15 Sequoia or later, in English, Spanish, French and 9 more languages, verified)
- [Devly](https://macbase.app/apps/devly): 60+ developer utilities in your macOS menu bar ($4.99, Developer Tools, Apple silicon, macOS 13 Ventura or later, in English, verified)
- [FlowSense](https://macbase.app/apps/flowsense-ai): An AI agent that guards your Mac's network ($29, $5 off for MacBase members, Security & Privacy, Apple silicon, macOS 14 Sonoma or later, verified)
- [NotchNudge](https://macbase.app/apps/notchnudge): Track AI usage and agent status from your Mac notch ($9.99, Coding Agents, open source, Apple silicon, macOS 14 Sonoma or later, in English, Spanish, French and 4 more languages, verified)
- [LocalEditor](https://macbase.app/apps/localeditor): A local workspace for notes, sketches, and code ($25, 15% off for MacBase members, Notes & Knowledge, Apple silicon, macOS 14 Sonoma or later, in English, verified)
- [Tilde](https://macbase.app/apps/tilde): The Finder alternative: a better way to work with files ($29.99, 15% off for MacBase members, File Management, Apple silicon, macOS 14 Sonoma or later, verified)