Repository navigation
TabPulse v0.1.0
Install
curl -fsSL https://raw.githubusercontent.com/imtripleq/tabpulse/main/install.sh | bashThe installer downloads the latest TabPulse.zip from Releases, puts the app in ~/Applications, adds the Claude Code hooks and starts TabPulse at login.
TabPulse is ad-hoc signed and not notarized, so macOS blocks the app if you download the zip in a browser and open it yourself. To install it by hand:
- Unzip it and move TabPulse.app to
~/Applications. - Run
xattr -dr com.apple.quarantine ~/Applications/TabPulse.app. - Add the hooks in Claude Code with
/plugin marketplace add imtripleq/tabpulseand/plugin install tabpulse@tabpulse.
Installed this way, TabPulse doesn't start at login. See Installing the zip by hand in the README.
Changes
Added
- Menu bar pill with a spinning ✳, the number of working sessions, an orange dot when one needs you, and a green dot when one finished while you were looking elsewhere. The green dot clears when you open the menu or look at that session's Ghostty tab. The ✳ turns grey when nothing is going on.
- Spinners and ● markers on Ghostty 1.4+ tab titles for sessions running directly in a Ghostty tab, handed back to Claude when a turn ends. Every ten seconds TabPulse peeks at Claude's own title to keep it current and to spot a turn stopped with Esc.
- Session list showing each session's title, what it is doing, and how long the turn has run, how long it has waited for you, or how long ago it finished. Clicking a session that runs in a Ghostty tab jumps to it. TabPulse never launches Ghostty or asks for Automation access just to look for a tab.
- Notification about ten seconds after a session finishes, skipped for the Ghostty tab you are looking at and for turns you stopped yourself. The wait lets a Stop hook that sends Claude back to work, such as
/goal, cancel it. It says Stopped when an API error such as a rate limit ended the turn. Clicking it jumps to the tab. Where macOS refuses TabPulse's own notifications, the banner goes out through osascript instead. - Style menu with a Tab spinner submenu and a Menu bar submenu, each split into sections. There are 16 tab spinners in two sections (Glyph: Braille, Bounce, Arc, Equalizer, Sparkle, Sine, Typing, Snake; Emoji: Moon, Garden, Heartbeat, Magic, Monkeys, Duck, Hatch, Slots) and 24 menu bar animations in three sections (Star: Spin, Breathe, Hop, Bloom, Neon, Rainbow, Morph, Sketch; Signal: Orbit, Comet, Radar, Wave, Helix, Equalizer, Pulse, Scanner; Playful: Chomp, Mochi, Kitty, Brainstorm, Rocket, Cradle, Prompt, Cube). Picking a menu bar style previews it for 3 seconds, even when nothing is working. The menu bar can speed up as more sessions work, and
--style-galleryshows every menu bar style at once. - Reduce Motion support: the menu bar shows a still pose of the chosen style, and each tab spinner holds one glyph, except Garden, which still grows with the turn.
- App icon.
- The Claude Code hook, on nine events (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PostToolUseFailure, Notification, Stop, StopFailure, SessionEnd), available through the installer or as a Claude Code plugin. It needs Claude Code 2.1.78 or newer. It marks a session as needing you only for notices that wait on you, such as permission prompts and dialogs. It ends a turn on Esc in any terminal, and on an API error, and it leaves compaction alone.
- One-line installer. It verifies the release zip against its published SHA-256 file and stops if that file is missing or doesn't match. It edits only the hooks in
settings.json(inCLAUDE_CONFIG_DIR, or~/.claude), keeps a backup, and checks the file is valid JSON before it changes anything.--app-onlyleavessettings.jsonalone for the plugin route, and running it again without--app-onlyonce the plugin is installed removes the old hooks. - Uninstaller that removes the hooks from
settings.jsonbefore deleting anything else, and stops with nothing removed if it can't. - Releases with
TabPulse.zipand its checksum, and release notes that explain how to install the zip by hand.