Skip to main content
Agent Watch keeps an eye on your Claude Code sessions so you don’t have to. It tells you the moment one finishes or needs your attention, and lets you jump straight to it — or answer from the toast without switching apps. Everything stays on your Mac.

​
Open it

Press ⌃ ⌥ M from any app.

​
How it works

1

Run your agents

Start one or more Claude Code sessions in any terminal — Terminal, iTerm, or Ghostty. Agent Watch picks them up automatically.
2

Keep working

A toast appears when a session finishes or is waiting on you (a permission prompt, a question). Click the toast to jump to that terminal, or type an answer right there.
3

Open the palette

Press ⌃ ⌥ M to see every live session at a glance. Each row shows the project name, what the agent last said, a status light, and how long it has been in that state. Press ↩ to go to the selected session.

​
Session states

Every session is in one of three states: The status light and the creature animation both say the same thing, so you can read the palette at a glance without stopping to parse text.

​
Characters

Each project gets its own pixel creature, chosen from its folder path — same repo, same character, every time. When two sessions want the same one, the second takes the next free character along, so no two on screen are ever alike. They walk while a session is working, shuffle about when one wants you, and stand still once it’s done.
Fish— Never stops moving, not even asleep.
Bird— Small, loud, and first to notice anything.
Puffer— Puffs up at the slightest provocation and deflates just as quickly.
Sprout— Grows a little every day and refuses to be hurried.
Crawler— Many legs, one direction. Does not turn around.
Rock— Moves about once a season, and only if asked twice.
Moth— Drawn to whatever is brightest, which is reliably the wrong thing.
Tadpole— Still becoming something. Fine with this.
Stick insect— Holds perfectly still and assumes that makes it invisible.
Jellyfish— Drifts wherever the current goes and calls it a plan.
Lizard— Basks, then bolts. There is no middle setting.
Crab— Sideways is a perfectly good direction.
Snail— Carries everything it owns and still arrives.
Owl— Sees everything and mentions none of it.
Bat— Navigates by shouting into the dark and listening.
Beetle— Armoured, deliberate, and quietly certain it is right.
Frog— Sits very still, then isn’t there.
Squid— Solves most problems by leaving a cloud behind.
Mushroom— Turned up overnight and behaves as though it always lived here.
Starfish— Five arms, no front, no particular plan.
Ant— Small, tireless, and carrying something four times its size.
Every character is a 12 × 12 pixel grid with its own colour, so it reads by shape and by colour — “the orange crab” always means Nipper.

​
Replying from the toast

When a session is waiting on you, the toast includes a text field. Type your answer and press Return — Dax finds the terminal running that session, brings it forward, and pastes your reply in. Works with Terminal, iTerm, and Ghostty. If the terminal can’t be identified, your answer goes to the clipboard instead and Dax tells you to paste it yourself. Without hooks, Dax reads the agent’s trace files every few seconds and infers whether it’s waiting. With hooks installed, Claude Code tells Dax directly — faster and certain. Install them from Settings → Tools → Agent Watch → Install Hooks. This adds two entries to ~/.claude/settings.json (backed up first):
  • Notification — fires the moment a session hits a permission prompt or finishes.
  • Stop — delivers the finished reply as it lands.
Remove Hooks takes out only Dax’s entries and leaves everything else untouched.

​
Plain-language summaries

What agents write is paragraphs. A toast has room for a line. When Say it in plain language is on, Dax rewrites the agent’s message into one sentence using Apple’s on-device model — no network, no cost, works offline. Requires macOS 26 and Apple Intelligence.

​
Options

Settings → Tools → Agent Watch:
  • A session finishes — toast when a turn is done.
  • One is waiting on me — toast on a permission prompt or question.
  • Play a sound — chime alongside the toast.
  • Pause watching — stop notifications without disabling the tool.
  • Say it in plain language — on-device AI summary of the agent’s message.
  • Let me answer from the toast — reply field on “needs you” toasts.

​
Privacy

Entirely on your Mac. Agent Watch reads the trace files Claude Code already writes to disk and never touches the network. The optional summary uses Apple’s on-device model — your code stays local.

​
Supported agents

Claude Code only for now. Codex writes trace files Dax can read, but has no hook to report state directly, so its sessions aren’t watched rather than half-supported.