Changelog
Release History
Every release, documented.
Initial Release
✨ Features
- macOS menu bar app monitoring all Claude Code sessions
- Instant macOS notifications when sessions need attention
- Click notification to focus exact terminal window/tab (Terminal.app, iTerm2)
- Terminal and IDE detection: Terminal.app, iTerm2, VS Code, Warp, Ghostty, IntelliJ
- Four status states: Idle (grey), Running (blue), Waiting (amber), Input Required (red)
- Provider badge showing agent identity (e.g. Claude = C)
- Auto-installs Claude hooks on first launch — zero manual config
- Hooks registered:
Notification,PreToolUse,PostToolUse,Stop,UserPromptSubmit - Session auto-cleanup when Claude process terminates (PID liveness check)
- Preferences: launch at login, notifications, sound, terminal auto-focus, retention
- Extensible architecture — adding any new agent CLI provider requires one new file
🏗 Architecture
- Hexagonal Architecture (Ports & Adapters) with DDD layers
- Swift 6 strict concurrency throughout
- Unix Domain Socket IPC (POSIX, not NWListener)
- Fire-and-forget
agentpulse-hookCLI — minimal overhead for the agent process
Roadmap
Coming up
Gemini CLI Support
Monitor Google's Gemini CLI sessions alongside Claude
Codex CLI Support
OpenAI Codex CLI integration
Running Animation
Animated pulse waveform in menu bar while agents are working
Apple Watch
Notifications on your wrist
Keyboard Shortcuts
Cycle through waiting sessions without touching the mouse
Snooze
Snooze notifications for a session during focus time