Agent Watchers

Your Claude Code sessions, live and interactive. A floating overlay that snaps to your screen edge, shows the state of every active session, and teleports you to its terminal in one click.

Thinking
Executing

Real-time monitoring

TokenEater detects every active Claude Code session via system processes. For each session, you see its state:

  • Idle
  • Thinking
  • Executing
  • Waiting
  • Sub-agent
  • Compacting

Click to teleport

Click any session capsule to teleport directly to its terminal window. No more hunting for the right tab or window.

Supported terminals

Watchers work with practically every terminal and IDE:

  • iTerm2, WezTerm, Terminal.app, Warp, Ghostty
  • VS Code, Cursor, Windsurf, Zed and other VS Code-based editors
  • tmux and screen sessions (in any terminal)

Dock effect

The floating overlay snaps to your screen edge (left or right). On hover, capsules grow with smooth spring animations, macOS dock-style.

Adjustable hover zone

Pick the width of the hover detection zone:

  • Minimal - 18 px, almost invisible when not in use
  • Narrow - 40 px
  • Medium - 80 px (default)
  • Wide - 130 px (legacy behavior)

This lets the overlay avoid stealing clicks from apps behind it, while staying accessible when you want it.

Display mode

Two modes for the session label:

  • Branch-first - branch as title when off main
  • Project + Branch - project name always visible, branch next to status
Agent Watchers require Claude Code to be running in your terminal. The watcher detects sessions automatically, no configuration needed.