Agent Watchers

A floating overlay that lists your live Claude Code sessions (Claude only). Move the cursor to the right edge of the screen to open it, click a session to jump to it.

Thinking
Executing

Reading a tile

Each tile shows a status: Idle, Thinking, Executing (running a tool), Waiting (needs your answer), Subagent or Compacting. Set Status legend to Simple to see only Idle or Working. A bar shows how full the session's context is.

Jump to a session

Click a tile to bring its app forward: Terminal, iTerm2, Kitty, WezTerm, Warp, Ghostty, Alacritty, tmux, screen, VS Code, Cursor, Windsurf (terminal or Claude Code extension), Zed, Sublime Text, JetBrains IDEs. Terminal, iTerm2, Kitty, WezTerm and tmux focus the exact tab or pane; tmux, WezTerm and Kitty need one config line from Settings -> Watchers -> Terminal setup.

Right-click a tile to open the project in Finder, copy its path or session ID, reveal the transcript, or hide it.

Settings

In Settings -> Watchers (turn the overlay off with Show session overlay). Quick toggles: Enable / Disable Agent Watchers in the menu bar right-click menu, or an Agent watchers toggle you can add to the popover in Studio.

  • Overlay style: Frost or Neon
  • Display mode: Branch priority (default, titles the tile with the git branch when off the default branch) or Project + Branch. A /rename name always wins.
  • Hover zone, how close to the edge the cursor must get: Minimal 18 px (default since 6.0, an earlier choice is kept), Narrow 40, Medium 80, Wide 130
  • Scan rate: 2s (default), 5s, 10s. Visibility after the last activity: 30m (default), 2h, 8h, 1d, 7d
  • Dock effect (tiles grow under the cursor), Left side (overlay on the left edge), Animations, Card size (60 to 160%, 110% by default)
Session missing? Claude Code must run on this Mac, in a terminal or the VS Code, Cursor or Windsurf extension. Old 2.0.x extension builds cannot be detected: update the extension.