↑ ↓ navigate · Enter open · Esc close

A coding-agent session monitor for Mac

Keep your agents
in sight.

Follow multiple Claude Code, Codex, and Grok sessions. See which is working, which needs you, and which has ended its turn.

Set up Agent Pulse Read the source ↗

MIT plugin · Included with Island for Mac

One view. Every session.Renderer examples
Agent Pulse example with Claude Code requesting permission, Codex working, and a Grok turn ended
Actual plugin renderer, illustrative sessions. An attention request sorts above working and ended turns.

Stay compact while agents work

The island stays compact until you hover. Explore a scrollable list of open sessions, with requests for input above ongoing work.

Step in when you’re needed

Supported questions and confirmed attention states move to the top. An ended turn stays distinct from a request for input. Codex automatic approval signals do not become amber warnings.

Return to the right session

Open an exact Codex desktop task, or return to a recorded terminal application on macOS. Terminal tab selection depends on the application; a resume command is available when direct opening is unavailable.

Multiple sessions.
One place to check.

Agent Pulse listens to local lifecycle hooks. Each tool reports a little differently, and the interface keeps that distinction.

Claude Code

CLI lifecycle hooks

Working, permission requests, supported questions, and turn end.

Codex

Desktop + CLI hooks

Exact desktop task links. Review and trust hooks in Codex before the first signal.

Grok

Official xAI CLI

Lifecycle hooks for activity; the local session registry helps identify closed sessions.

Connect once.
Keep your usual workflow.

Agent Pulse ships with Island for Mac. Activate Island, enable Agent Pulse in Market → My plugins, then select Connect agents or … → Connection settings. You do not need Rust for the bundled plugin.

Island 1.x costs US$19 once for two Macs, with 1.x updates and optional future major upgrades. There is no free trial. The public download supports Apple silicon and macOS 12+. Pricing and purchase terms ↗

To build the plugin yourself instead, follow the steps below with stable Rust supporting edition 2024 and a compatible Island host and CLI. Plugin builds support macOS and Linux; no public Island Linux installer is included in this release.

  1. Build the plugin

    Run this in your terminal. Packaging creates a local plugin folder; it does not install hooks.

    Clone and build
    git clone https://github.com/Sullivansome/agent-pulse.git
cd agent-pulse
./scripts/package.sh

  2. Install in Island

    Review the requested permissions. You can also select the built folder through Market → My plugins → Install from folder.

    Install the local package
    island-cli plugin install ./dist/com.sullivansome.agent-pulse

  3. Connect and review

    This adds hooks for all three tools and backs up changed configuration. Restart Claude Code and Grok. In Codex, review and trust the hooks in Settings → Hooks or /hooks.

    Install local lifecycle hooks
    ./scripts/agent-pulse-setup.sh

Start a task to confirm the connection. Installed hooks and recorded activity are shown separately. Existing sessions appear after their next lifecycle signal.

Setup reference ↗

Status stays
on your machine.

The receiver records session identifiers, project names, lifecycle state, timestamps, and process identity. It keeps bounded request metadata and input hashes to match events.

Prompts, tool arguments, results, terminal contents, and transcripts are not retained. No API key or remote status service is needed.

Inspect the data contract ↗
Can I monitor multiple Claude Code or Codex sessions?

Yes. Connected sessions appear separately, with their project and latest lifecycle state. Hover over Island to inspect the list and open a session from its row. Start a task after setup so the session can send its first signal.

Does this show token usage or account quotas?

No. Agent Pulse monitors local session activity and lifecycle events. Check usage and account limits in the provider’s own app or account settings.

Does “Turn ended” mean the job is done?

It means the agent emitted a Stop event for one turn. A larger goal may continue. The next prompt starts work again; an ended turn is not a request for your input.

What happens when I close a terminal?

Session-end hooks and process tracking remove closed CLI sessions. Desktop sessions without a controlling terminal rely on session hooks. Process-inspection errors are not treated as proof of closure.

Can it tell me that an agent is stuck?

After 10 minutes without a hook, working sessions show “No recent signal”. A long model or tool call can also be silent. Agent Pulse reports what it observed; it cannot prove a task is stuck.

How do I disconnect?

Remove the hooks before deleting Island or plugin data. For Island installed in Applications, run:

Remove hooks from bundled Agent Pulse
/Applications/Island.app/Contents/Resources/plugins/com.sullivansome.agent-pulse/island-plugin-agent-pulse setup --remove

If you built from source, run ./scripts/agent-pulse-setup.sh --remove from that checkout. Disabling the surface in Island does not remove hooks. Unrelated hooks, backups, and recorded status are preserved.

Is the plugin free?

Agent Pulse is free and MIT licensed. Running it in the official Island app requires an Island license: US$19 once for two Macs and Island 1.x updates. It does not include paid AI services. Compatible independent hosts may use the MIT plugin under its own terms.

Island terms ↗