Skip to content

v0.2.0 - tmux popup mode + community contributions

Choose a tag to compare

View all tags
@1270011 1270011 released this 10 Apr 21:17
v0.2.0
fe7ac69

v0.2.0 — tmux popup mode + community contributions

Two community PRs shipped in this release. The buddy is getting better thanks to contributors.

New: tmux popup overlay mode

When running inside tmux (>= 3.2), your buddy now appears as a floating popup in the bottom-right corner instead of the status line. Includes:

  • Animated ASCII art with speech bubbles
  • ESC passthrough (closes popup momentarily, forwards ESC to Claude Code, reopens)
  • Dynamic resizing when reactions appear/disappear
  • F12 scroll mode (hides popup, activates tmux copy-mode)
  • Configurable appearance via /buddy style, /buddy position, /buddy rarity
  • Session isolation — multiple Claude Code sessions in parallel, each with their own buddy

Non-tmux users see zero changes — the installer auto-detects your environment and chooses the right mode.

Note: Switching between tmux and non-tmux mode requires re-running bun run install-buddy.

Fixed: PostToolUse hook was non-functional since v0.1.0

The hook that detects errors and test failures in Bash output was reading the wrong field name (.tool_result instead of .tool_response). It silently exited on every invocation. Fixed by @birkdev — your buddy now reacts to errors immediately, not just at end-of-response.

Improvements

  • macOS compatibility — grep -P replaced with sed in hooks (grep -P doesn't exist on macOS)
  • Safe JSON output — hooks use jq -n instead of heredoc strings (prevents broken JSON from special characters in reactions)
  • Reaction TTL — speech bubble auto-expires after 20 seconds instead of staying forever
  • Configurable comment cooldown — /buddy frequency [seconds] to control how often the buddy comments
  • Session isolation — parallel Claude Code sessions no longer overwrite each other's reactions

Upgrade

cd claude-buddy
git pull
bun install

# Optional: backup before re-installing
bun run backup

bun run install-buddy

Restart Claude Code after installing.

Contributors

  • @gzenz — tmux popup overlay, session isolation, configurable appearance (#6)
  • @birkdev — PostToolUse hook bugfix (#13)

Thank you both for making everyone's buddy better.

Contributors

gzenz and birkdev
Assets 2
Loading