claude-pets

You should see openpets.

3. Enable automatic Claude reactions

Install Claude Pets hooks globally:

bunx @open-pets/claude-pets install

This updates your user-wide Claude Code settings:

~/.claude/settings.json

The installer preserves unrelated settings and creates a backup before writing.

Restart Claude Code after installing, then run /hooks in Claude Code. The Claude Pets commands should appear under user settings. If they do not appear there, Claude Code has not loaded the hooks yet.

Test it

With OpenPets running:

bunx @open-pets/claude-pets test-event thinking

Your pet should animate briefly, then return to idle.

You can also try:

bunx @open-pets/claude-pets test-event testing
bunx @open-pets/claude-pets test-event success

Uninstall

Remove the global hooks:

bunx @open-pets/claude-pets uninstall

This only removes Claude Pets managed hook commands from ~/.claude/settings.json.

Troubleshooting

OpenPets is not reacting

1. Start the OpenPets desktop app.
2. Run:

bunx @open-pets/claude-pets test-event thinking

3. If nothing happens, restart OpenPets and try again.

Hooks are not firing

1. Make sure you installed hooks:

bunx @open-pets/claude-pets install

2. Restart Claude Code.
3. In Claude Code, run /hooks and confirm the Claude Pets command appears under user settings. Treat /hooks as the source of truth: if Claude Pets is not listed there, Claude Code has not loaded the hooks.
4. Check that ~/.claude/settings.json contains @open-pets/claude-pets.
5. If bunx @open-pets/claude-pets test-event thinking works but normal Claude Code prompts do not update the pet, the desktop app is working and the issue is hook loading.

On Windows, you can also test the hook command directly from PowerShell while OpenPets is running:

'{"hook_event_name":"UserPromptSubmit"}' | bunx --bun @open-pets/claude-pets hook

If this makes the pet think, the hook command works and Claude Code still needs to load the hook config.

Bun is missing

Install Bun first:

https://bun.com

Restore settings from backup

Every write creates a backup next to the settings file:

~/.claude/settings.json.bak-<timestamp>

Quit Claude Code, copy the backup over ~/.claude/settings.json, then restart Claude Code.

Advanced

Project-only install

Global install is recommended. Project-only hooks are written to .claude/settings.local.json, but Claude Code must load that project settings file for the hooks to run. Always verify project-only installs with /hooks.

If you only want Claude Pets hooks in one project, run this from that project root:

bunx @open-pets/claude-pets install --project

This writes project-local settings instead:

.claude/settings.local.json

Uninstall project-local hooks with:

bunx @open-pets/claude-pets uninstall --project

Preview settings without writing

bunx @open-pets/claude-pets install --dry-run

Print the hook settings snippet

bunx @open-pets/claude-pets print

Production hooks use this command:

bunx --bun @open-pets/claude-pets@<package-version> hook

The installer derives <package-version> from the installed package so hook commands stay in sync with the published release.

Diagnose your setup

bunx @open-pets/claude-pets doctor

Use --project to inspect project-local hooks:

bunx @open-pets/claude-pets doctor --project

If you launch Claude Code with CLAUDE_CONFIG_DIR, run doctor with the same environment variable so it inspects the same profile:

CLAUDE_CONFIG_DIR=/path/to/claude-profile bunx @open-pets/claude-pets doctor

Commands

claude-pets install [--dry-run] [--project] [--local-command]
claude-pets uninstall [--dry-run] [--project]
claude-pets print [--local-command]
claude-pets hook
claude-pets test-event <state>
claude-pets doctor [--project]

Local development

git clone https://github.com/alvinunreal/claude-pets.git
cd claude-pets
bun install
bun test
bun run typecheck
bun run build

Install hooks pointing at your local checkout:

bun src/cli.ts install --local-command

Recommended setup

Use both OpenPets integrations for the best experience:

1. OpenPets MCP - lets Claude intentionally speak/control the pet.
2. Claude Pets hooks - automatic background state changes while Claude works.