{"slug": "how-to-know-when-a-claude-code-agent-needs-your-approval-without-watching-the", "title": "How to Know When a Claude Code Agent Needs Your Approval (Without Watching the Terminal)", "summary": "Blume, a developer tool, addresses the problem of background coding agents silently waiting for user approval by offering desktop-level monitoring across Claude Code, Codex, and Cursor. The tool displays which agents are running, working, or stuck, and also tracks plan usage to explain why an agent stopped. Claude Code's built-in agent view and Notification hooks provide alternative alerting methods, but Blume aims to centralize oversight and suggest configuration fixes.", "body_md": "The promise of background coding agents is that you kick off a task and go do something else. The reality, for a lot of people, is kicking off a task, doing something else, and coming back forty minutes later to find the agent stopped three minutes in, waiting for permission to run a command.\n\nAn agent that waits silently is worse than an agent that interrupts you, because the silence costs you the whole gap. Here is every practical way to get notified the moment a Claude Code agent needs your input.\n\nDisclosure: I work on [Blume](https://blume.codes), covered as one option below.\n\nClaude Code has a built-in answer for multiple sessions: agent view. It shows what every session is doing and which ones need input, lets you dispatch new sessions, and while it is open, the terminal tab title shows a count of sessions awaiting input.\n\nCrucially, agent view also sends notifications through your configured terminal notification channel when a background session starts needing input, finishes, or fails. This uses the same `preferredNotifChannel`\n\nsetting as the rest of Claude Code, so make sure that is set to something you will actually notice (`terminal_bell`\n\nor your OS notifier).\n\n**Good for:** running several Claude Code sessions from one terminal.\n\n**The gap:** you need agent view open, and it covers Claude Code only.\n\nFor full control, Claude Code fires a `Notification`\n\nhook event with types like `agent_needs_input`\n\nand `agent_completed`\n\n. A hook is a shell command, so you can route it anywhere: macOS notification, Slack webhook, ntfy push to your phone.\n\nA minimal macOS example in `.claude/settings.json`\n\n:\n\n```\n{\n  \"hooks\": {\n    \"Notification\": [\n      {\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"osascript -e 'display notification \\\"Claude needs input\\\" with title \\\"Claude Code\\\" sound name \\\"Glass\\\"'\"\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\nSwap the osascript for a `curl`\n\nto a Slack webhook or ntfy.sh topic and the alert follows you off the machine.\n\n**Good for:** people who want alerts in a specific channel, deterministically.\n\n**The gap:** per-machine setup, and it alerts without showing state. You still open the terminal to see what the agent wants.\n\nOne reason this problem feels worse than it should: for a while, background subagents could be silently blocked by permission prompts that never surfaced, which looked like a hung agent. Since v2.1.186, background subagents surface their permission prompts into the main session, labeled with the subagent's name, and you approve with a keypress.\n\nIf agents seem to hang with no prompt anywhere, update Claude Code before debugging anything else. Several apparent hangs in older versions were exactly this bug.\n\nThe options above are per-tool and per-terminal. [Blume](https://blume.codes) approaches it from the desktop: it monitors your coding agents across Claude Code, Codex, and Cursor and shows at a glance which are running, which are working, and which are stuck waiting for approval, without you cycling through terminal tabs. Because it also tracks plan usage, \"why did my agent stop\" has one more answer visible in the same place: sometimes the agent is not waiting for permission, it is waiting for your 5-hour window to reset.\n\nBlume's broader premise is that interruptions like these are often symptoms of setup problems. An agent that constantly asks for permission usually has a permissions config that does not match how you actually work, and Blume's suggestion engine flags exactly that kind of mismatch (along with rules your agents ignore and hooks that never fire) and proposes fixes you approve or reject.\n\n**Good for:** multi-agent, multi-project setups.\n\n**The gap:** if you run one agent in one terminal, the built-ins above are probably enough.\n\nThe best notification is the one that never fires. Three habits shrink the number of approval stops dramatically:\n\n`npm test`\n\nevery time, put it in your allowlist in `.claude/settings.json`\n\n. Every rubber-stamp prompt is pure interruption**Do I get notifications when Claude Code runs in the background?**\n\nYes, if agent view is open or you configure the Notification hook. Otherwise a stopped background session waits silently, which is the trap this post exists to fix.\n\n**Can I get alerts on my phone?**\n\nYes. Point the Notification hook at a push service like ntfy.sh or a Slack webhook.\n\n**Why does my agent stop even though I approved everything?**\n\nCheck three things in order: an unsurfaced permission prompt (update Claude Code), a hit usage limit (`/usage`\n\n), or the agent finished and the completion notification went nowhere.\n\nIf you have a notification setup that survives real use, especially for a fleet of parallel agents, share it in the comments.", "url": "https://wpnews.pro/news/how-to-know-when-a-claude-code-agent-needs-your-approval-without-watching-the", "canonical_source": "https://dev.to/pederaa/how-to-know-when-a-claude-code-agent-needs-your-approval-without-watching-the-terminal-5ekf", "published_at": "2026-08-05 13:48:57+00:00", "updated_at": "2026-08-05 14:03:08.193756+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools"], "entities": ["Blume", "Claude Code", "Codex", "Cursor"], "alternates": {"html": "https://wpnews.pro/news/how-to-know-when-a-claude-code-agent-needs-your-approval-without-watching-the", "markdown": "https://wpnews.pro/news/how-to-know-when-a-claude-code-agent-needs-your-approval-without-watching-the.md", "text": "https://wpnews.pro/news/how-to-know-when-a-claude-code-agent-needs-your-approval-without-watching-the.txt", "jsonld": "https://wpnews.pro/news/how-to-know-when-a-claude-code-agent-needs-your-approval-without-watching-the.jsonld"}}