@ifbars/agent-pets
v1.0.4
Published
Local-first desktop pets that mirror Codex and other coding agents activity.
Maintainers
Readme
Agent Pets
Bring your Codex pet anywhere.
Agent Pets puts a tiny Codex-compatible pet on your desktop. It can show coding-agent status, run as a manual desktop companion, or follow a simple local status file.
Quick Start
Run it with Bun:
bunx @ifbars/agent-petsOr install it on your PATH:
bun install -g @ifbars/agent-pets
agent-petsRun a specific pet:
agent-pets --pet pinguUse it without an agent:
agent-pets --provider desktop --pet pinguPrefer an app binary? Download the latest Windows, macOS, or Linux build from GitHub Releases.
OpenCode
Install the companion plugin:
opencode plugin opencode-agent-pets --globalOpen OpenCode, then toggle the desktop pet:
/petAgent Modes
Agent Pets supports:
- Codex
- OpenCode
- Claude Code
- T3Code
- Desktop-only pets
- JSON status files for custom integrations
The OpenCode plugin keeps Agent Pets updated with realtime session status. You can also run OpenCode mode directly:
agent-pets --provider opencodeCustom Pets
Pets use the Codex pet package shape: a pet.json manifest plus a transparent spritesheet.
Start here: Make a Custom Pet
Development
bun install
bun run agent-pets
bun run typecheck
bun run testPackage a local desktop build:
bun run packRelease checklist: RELEASE.md
Privacy
Agent Pets is local-first. It does not patch Codex, inject into other apps, upload prompts, upload source code, or execute scripts from pet packages.
See PRIVACY.md and SECURITY.md.
