Aby Claude Watcher

Real-time dashboard for your Claude Code sessions. See every session at a glance — thinking, running tools, or waiting for your input.

If you run more than one Claude Code session at a time, you know the pain: you start a long task in one terminal, switch to another, and twenty minutes later you realise Claude has been silently waiting for a permission prompt. Aby Claude Watcher keeps every session on screen, notifies you the moment one needs you, and jumps you back to the right terminal in one click.

Built at Aby Agency to solve our own daily workflow — shipped as MIT open source for anyone who ships with Claude.

Compact view — always-on-top list mode

Micro view — ambient status dots, pinned to a corner

The most minimal mode — just dot + name per session. Click a line to jump to its terminal.

• Auto-detects every Claude Code session running on your Mac (~/.claude/sessions/)
• Five states, color-coded — thinking, running, waiting, error, completed
• Two views — grid and compact list, drag to reorder
• Always-on-top — pin the window over your IDE
• Per-session notifications — in-app toast + sound when a session needs attention
• One-click focus terminal — supports iTerm2, Terminal.app, Warp, VSCode, Cursor, Ghostty, kitty, WezTerm, Hyper
• Resume session from the dashboard
• Remote Control indicator — globe icon when a session exposes a remote URL
• Tool pills color-coded by category (Bash, Read, Edit, Agent, MCP…)
• Cost estimation and token counters per session
• Git branch displayed per session
• Bilingual UI — French and English, runtime switcher
• Menu-bar icon with tray popover summary
• Dock badge for waiting sessions
• Auto-launch at login (opt-in)
• Manual update checker via GitHub releases (no auto-download, no phone-home)

1. Download the latest .dmg from Releases
2. Open it and drag Aby Claude Watcher to /Applications
3. Important — first launch: the app is ad-hoc signed (not notarized by Apple). macOS Gatekeeper will block a double-click. Instead:
   • Right-click the app in /Applications → Open
   • A warning dialog appears → click Open
   • From then on, the app launches normally

Intel (x64) build not yet available — open an issue if you need one.

git clone https://github.com/aby-agency/aby-claude-watcher.git
cd aby-claude-watcher
npm install
npm start        # production mode
npm run dev      # with devtools

Build the .dmg yourself:

npm run build

Two helper binaries live in bin/. Add them to your PATH to make the "Focus terminal" button land in the exact terminal window that started the session:

# in your .zshrc / .bashrc
export PATH="$PATH:/path/to/aby-claude-watcher/bin"

Then:

cc       # start a new Claude Code session (wraps `claude`)
cwa      # resume the last session (wraps `claude --resume`)

The wrappers open a Unix socket at /tmp/aby-claude-watcher.sock and register the host terminal's identifier so the app can switch back to it precisely.

The Focus terminal feature uses AppleScript. On first use, macOS will ask for Automation permission for your terminal app — approve it once in System Settings → Privacy & Security → Automation.

main.js         Electron main — window, IPC, tray, notifications
watcher.js      Session discovery + JSONL parsing + state machine
socket.js       Unix socket (cc / cwa wrappers)
focus.js        Terminal focus via AppleScript
config.js       Persistent config (debounced writes, saveSync on shutdown)
i18n.js         Translations (FR / EN) — shared main ↔ renderer
preload.js      Context bridge
ui/             Renderer — vanilla HTML/CSS/JS, no framework
bin/            cc / cwa shell wrappers

No build step for the UI, no bundler, no framework. Opening ui/index.html in a browser gets you 90% of the look. The dependency tree ends at Electron itself.

The design decisions (states, polling interval, notification cooldown, waiting delay) are documented in CLAUDE.md.

Built with Electron, iconography inspired by Lucide.

MIT © Aby Agency