Two pieces talk through files. tabpulse-hook.sh, in bash and jq, runs on SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PostToolUseFailure, Notification, Stop, StopFailure and SessionEnd. It writes one JSON file per session to .claude/tabpulse/sessions/ in the user's home folder, with the state (working, waiting or done), when the state and the turn began, and what the session is doing, such as running Bash or permission to use Edit. The installer and a Claude Code plugin share the same script.
The TabPulse app, in Swift and AppKit, reads those files once a second. It sets each Ghostty tab title through AppleScript's per-terminal name override, draws the menu bar pill and the session list, and jumps to a session's tab when you click its row. A Finished banner arrives about ten seconds after a turn ends, unless you're already looking at that tab. A reminder comes once a session has waited on you for 5 minutes, and Control-Option-Command-J jumps to the tab that needs you from any app. While Claude works, it holds a power assertion so the Mac stays awake and the screen can still sleep.
There are 16 tab spinners and 24 menu bar animations. Each spinner frame shows for one 0.12 s tick, and every working tab steps on the same tick. Under Reduce Motion every tab spinner but Garden holds one frame, and the menu bar shows a still pose. A one-line installer, an uninstaller and a website on GitHub Pages complete it.
I built TabPulse with an AI pair programmer; every change went through the checks below and my review.