AI Agent Status
macOS menu bar app Free

Know which agent is waiting on you.

One menu bar item for each coding agent session that is working or waiting on you, with how long it has been running. Claude Code, Codex, Gemini CLI and OpenCode.

Download for Mac Version 1.0.0 · macOS 15 or later
Menu bar

Five states, one glyph per session.

Each agent keeps its slot, and its state shows as motion and colour. Or switch to a single icon and a count in Settings.

Running
A blue arc spins around the glyph while the agent works on a turn.
Needs you
The glyph fills amber and pulses until you answer an approval or a question.
Failed
A still red ring when a turn ends in an error or the process dies mid-turn. It stays until you clear it.
Finished
Green with a tick until you have seen it. Once the process exits, the slot closes after 10 seconds.
Idle
Session open, nothing happening. Dim and still.
Supported agents

It reads the files your agents already write.

No plugin, hook or wrapper to install. Each session also needs a live process, so a closed terminal never shows as running.

Agent Reads Needs you when
Claude Code ~/.claude/sessions/<pid>.json
~/.claude/projects/…/<sessionId>.jsonl The session file says status: "waiting". No quiet period.
Codex ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl The last item is a tool call with no output, and the file has been quiet for 5 seconds.
Gemini CLI ~/.gemini/tmp/<project>/chats/session-*.jsonl A turn has ended on a reply and the file has been quiet for 5 seconds. Gemini CLI writes no approval signal, and never reports finished.
OpenCode ~/.local/share/opencode/opencode.db The newest part is a tool still running, and its rows have been quiet for 5 seconds.
Read onlyIt opens no agent file for writing. The OpenCode database is opened read-only.
No networkIts one network request checks for new versions of the app, and only after you switch that on.
Measured onClaude Code 2.1.290, Codex 0.154.0, Gemini CLI 0.62.0, OpenCode 1.18.23 and 2.0.32.
Review

One click to the terminal that is asking.

"Review" on a session that needs you brings its terminal to the front. It finds the terminal from the process, not from a window title.

  1. 1Walks up the session's parent processes to the app that hosts it.
  2. 2Inside tmux, follows the client attached to that session back to its terminal, and shows the pane.
  3. 3No app found: opens the working folder in Finder.
web-app Claude Code
Asking to run a database migration
2mopus-5-5
web-app
Migration file written to db/migrations.
Waiting for approval to run the migration.
Allow this command? (y/n)
Notify me when an agent
Notifications

Hear about it when you are in another window.

A macOS notification when a session needs a reply or approval, or fails. Finishes is off until you switch it on. The title is the project and the agent, so you know which one without opening anything.

AI Agent Status app icon

AI Agent Status

Free. Version 1.0.0, macOS 15 or later. Signed with a Developer ID and notarised by Apple. Signed updates, when you choose to get them.

Download for Mac