How openpetshq/openpets works
OpenPets is a desktop companion platform: users launch the app to get an animated pet, then manage pets and enable plugins; optional local agent integrations can trigger pet reactions. The map preserves the documented plugin SDK, catalog, pet-management, voice, and team check-in capabilities. Several subsystem paths are exact enclosing directories because their implementation files were not sampled; dashed edges mark relationships not verified in the excerpts.
Main entry points: plugin-runtime.ts Plugin runtime · pet-window.ts Pet windows · main.ts Desktop app · main.tsx Control Center
Components 20
Desktop experience
- Desktop app
apps/desktop/src/main.ts - Control Center
apps/desktop/src/renderer/src/main.tsx - App state
apps/desktop/src/app-state.ts - Team check-ins
apps/desktop/src/manager-check-in-service.ts
Pet runtime
- Pet windows
apps/desktop/src/pet-window.ts - Pet motion
apps/desktop/src/pet-motion-engine.ts - Pet chat
apps/desktop/src/default-pet-chat.ts - Pet activities
apps/desktop/src/pet-activities.ts - Pet packages
packages/pet-format/src/package.ts
Plugin platform
- Plugin catalog
apps/desktop/src/plugin-catalog.ts - Plugin runtime
apps/desktop/src/plugin-runtime.ts - Plugin SDK
packages/sdk/src/index.ts - Official plugins
plugins/official
Integrations
- Agent clients
packages/client/src/index.ts - MCP server
packages/mcp/src/server.ts - Agent setup
apps/desktop/src/agent-setup.ts - Voice assistant
apps/desktop/src/voice-assistant-host.ts - Teams UI
apps/desktop/src/renderer/src/teams
Other components
- User
- Coding agent
Connections 15
- User → Desktop app: launches
README.md - Desktop app → Pet windows: shows pets
- User → Control Center: manages pets
README.md - Control Center → Plugin catalog: configures plugins
- App state → Pet packages: validates packages
apps/desktop/src/app-state.ts - Pet motion → Pet windows: moves windows
apps/desktop/src/pet-motion-engine.ts - Pet chat → Team check-ins: reads check-in state
apps/desktop/src/default-pet-chat.ts - Plugin SDK → Plugin runtime: provides APIs
- Plugin runtime → Pet windows: controls pets
- Official plugins → Plugin runtime: runs in
- Coding agent → MCP server: invokes tools
README.md - MCP server → Agent clients: uses client
- Agent setup → Agent clients: configures access
- Voice assistant → Pet chat: supports conversation
apps/desktop/src/default-pet-chat.ts - Teams UI → Team check-ins: manages check-ins