openpets

# OpenPets OpenPets is a desktop companion app for coding agents. The desktop app runs locally and exposes pet controls through CLI, MCP, hooks, plugins, and local IPC. Use this skill to help users onboard quickly and safely: - install or verify the OpenPets desktop app - install pets from the public catalog - configure Claude Code, OpenCode, Cursor, Codex, or another MCP client - configure a project to use a specific pet - validate `openpets_status`, `openpets_react`, and `openpets_say` - explain how OpenPets works - troubleshoot setup problems ## CLI rule: install once, then use openpets For the cleanest onboarding, install the OpenPets CLI globally first: ```bash npm install -g @open-pets/cli ``` Then use the `openpets` command: ```bash openpets <command> ``` If the user does not want a global install, is in CI, or only needs a one-off command, use this fallback instead: ```bash npx -y @open-pets/cli@latest <command> ``` For MCP server config, prefer the dedicated MCP package: ```bash npx -y @open-pets/mcp@latest --pet <pet-id> ``` Do not imply the desktop app installs a shell command by itself. The `openpets` command comes from the optional npm global CLI install. ## Mental model ```text Claude/OpenCode/Codex/Cursor/MCP client -> OpenPets MCP, plugin, hook, or CLI -> @open-pets/client -> local IPC discovery/token -> OpenPets desktop app -> default pet or selected agent pet lease ``` OpenPets requires the desktop app to be installed and running fo...