pet · Your desktop companion

Follows Claude Code sessions with a pose for busy, idle or waiting, and a nudge when you are needed.

The pet is free and closed source. Its hooks and state contract are open source.

Downloads

Loading published installers…

Use Homebrew to install the hook, register session events and install the pet:

brew install x-wink/tap/pet-hook
pet-hook setup
brew install --cask x-wink/tap/oxforge-pet

Keep both up to date with brew upgrade.

For manual installation, download the pet and get the hook for your platform from pet-hook Releases, place it on PATH and run pet-hook setup.

pet-hook writes session state and pet-state defines the shared contract. Both live in the cchud repository.