Pulse · Waiting lamp for agent sessions

Which agent needs you.

Red means blocked. Your turn stays quiet. Every lamp says why.

macOS 14+MITSep 30, 2026Menu bar

Illustrative session list 1 · 4m
1 needs you · 1 running · 1 your turn
  • Add a package · Claude

    Bash: npm install

    4m
  • Fix the flaky test · Claude

    Bash · swift test · 12m ago

    14m
  • Review failing CI · Codex

    titpea · 1m ago

    Your turn
  • Terminal session running · Pi

    Started before Pulse — details after its next step

hook events · processesClick a row to go · › for details

Know which session needs you.

Red means blocked

A permission or question waits; its banner leaves once answered.

Your turn, quietly

Finished turns are counted in the header; no banner, no sound.

Last step, turn time

Running rows show the latest tool step and the turn's length.

Orange means stalled

Twenty minutes without news; the row names the last step.

Seven agents, own hooks

Five turn red; Codex and Cursor show running and your turn.

Click to go

Its terminal when known, else the app; › shows details.

Where your data goes.

  • State comes only from each agent's own hooks; Pulse reads no session files, transcripts or protected app data.
  • The event log keeps each prompt redacted and cut to 200 characters, in a file only you can read, on this Mac.
  • Update checks ask GitHub anonymously for the latest public release and open its page.

v28.0.0Sep 30, 2026Release notes ›

FAQ

Which agents show waiting?

Five: Claude Code, Gemini CLI, Copilot CLI, OpenCode and Pi, through the hook, plugin or extension each vendor documents. Codex and Cursor show running and your turn only, and say they do not report waiting. Install them from the setup card on first open or in Settings → Hooks; for Codex, Pulse writes only ~/.codex/hooks.json, then you run /hooks in Codex to trust it. Only observe-only events are added, and removing them restores each file byte for byte; a file changed since then loses only Pulse's entries. A session that started before Pulse shows as process only until its next step.

Why is an agent not turning red?

Open Settings → Hooks. Each agent on this Mac has a row: whether its hook is installed (or why it failed) and how long ago its last event arrived, with its own Install or Remove button. Copy report gives the same as plain text, without paths, prompts or sessions.

Does Dismiss answer the agent?

No. Dismiss on the banner, like ⌘D in the tray, only stops Pulse reminding you of that wait and withdraws the banner. The prompt still waits in the agent's own window, and Pulse stays in the background.

Why does macOS block the first open?

Current builds are ad-hoc signed and not notarized. Click Open Anyway in System Settings → Privacy & Security, or clear quarantine with xattr -dr com.apple.quarantine /Applications/Pulse.app. Since macOS 15, Control-click Open no longer lets it through.

How do I remove Pulse?

Settings → Uninstall Pulse… lists what it will remove, then takes out every agent's Pulse hooks, the login item and ~/Library/Application Support/Pulse, quits, and shows Pulse.app in Finder for you to drag to the Trash. If a hook cannot be removed, it stops and deletes nothing.

Pulse