Run 10 agents.
Know which one needs you.

A macOS menu bar app that monitors your Claude Code sessions. See status at a glance, jump to the right window, get notified when agents need your input.

Download for macOS View on GitHub

or brew install ericermerimen/tap/agentping

At-a-glance session status

Needs Input — Agent is waiting for you. Permission prompt, question, or tool approval.
Error — Something went wrong. Click to jump straight to the problem.
Ready — Agent finished and needs your review. Teal highlight until you interact.
Running — Agent is working. Writing code, running tests, reading files.
Idle — Session is open but between tasks. Waiting for your next prompt.
Done — Task completed or process exited. Auto-purged after 24 hours.
One-click window jump Project grouping Context window tracking Cost tracking Global hotkey (Ctrl+Opt+A) Pin sessions macOS notifications Search and filter Context menu actions HTTP API (localhost) CLI for scripting Auto-purge stale sessions

Get started in 2 minutes

macOS 14 (Sonoma) or later. No Xcode needed.

Terminal 
$ brew install ericermerimen/tap/agentping
$ brew services start agentping
# Open Preferences, click "Copy Hook Config"
# Paste into ~/.claude/settings.json
Terminal 
$ curl -fsSL https://raw.githubusercontent.com/ericermerimen/agentping/main/Scripts/install-remote.sh | bash
Terminal 
$ tar xzf AgentPing-*.tar.gz
$ cp -r AgentPing.app /Applications/
# Download from GitHub Releases

How it works

Claude Code → agentping report → localhost:19199 → menu bar (hook events) (CLI post) (HTTP API) (SwiftUI popover)

Claude Code hooks call agentping report on every tool use, stop, and notification. The CLI posts to the embedded HTTP API. DirectoryWatcher picks up changes via FSEvents. The popover updates reactively. Click any session to focus its terminal or editor window.