Never miss an agent’s permission prompt

It starts with the tab

When an agent reports that it needs a permission, a question or a sign-in, its tab turns Needs you: an amber badge, pill and underline. That state stays until the agent itself reports that it continues. Opening or typing into the tab never clears it, because the agent is still blocked.

Then it finds you

• Looking at that tab: nothing, because you can see it.
• SplitNest in front, but another tab, workspace or Settings shown: an in-app notice at the bottom right with a Show button.
• SplitNest minimized or behind another program: a Windows notification. Clicking it brings SplitNest back and shows that exact tab. The taskbar button also flashes, and a small amber dot stays on it until you have seen the tab.

Keep your prompt out of the notification

Notifications use SplitNest's own words, such as Claude Code needs permission, plus the workspace and tab name. The agent's session title and message can contain your prompt, so they are left out unless you turn on Include what the agent wrote. It is off by default.

A bell is a guess, and labelled as one

For an agent that does not report its state, a terminal bell is treated as "Needs you?", shown dashed. Estimated states do not notify unless you turn that on in Settings, so a stray bell does not wake you up.

If several are waiting

More than three Windows notifications within 10 seconds become one summary. The agent inbox lists everything waiting right now, and Ctrl+Shift+U walks through them.

If no banner appears

Windows needs a Start menu entry to show an app's notifications; SplitNest adds one with the first notification. Send a test notification in Settings shows whether Windows accepts them. If no banner appears, check Do Not Disturb and SplitNest's entry in Windows Settings → System → Notifications.