OpenPetsHQ/openpets

Local first, desktop companion platform with animated pets, plugin SDK and coding-agent integrations.

What it solves

OpenPets provides a way to add animated desktop companions that reduce workspace loneliness and can be transformed into functional productivity tools. It bridges the gap between simple desktop pets and AI-driven agents, allowing developers to visualize the status and reactions of their coding agents (like Claude Code or Cursor) through a physical-feeling presence on the screen.

How it works

The platform consists of an Electron-based desktop application that renders animated pets. It uses a modular architecture with three main layers:

  1. Plugin System: A sandboxed JavaScript/TypeScript runtime (SDK v3) allows developers to create custom behaviors. Plugins can trigger animations, display HUDs, and manage schedules without having direct access to the system unless permissions are granted.
  2. Agent Integration: Using the Model Context Protocol (MCP), OpenPets acts as a server that AI agents can call. This allows an agent to trigger a specific reaction (e.g., "thinking" or "success") or display a speech bubble on the desktop pet based on the agent's current task.
  3. Local-First Design: All AI integrations and data are handled locally. Users configure their own API keys for providers like OpenAI or Anthropic, and the app uses local sockets with security tokens for communication.

Who it’s for

  • General Users: People who want a cute, interactive companion for their desktop with built-in tools like Pomodoro timers and hydration reminders.
  • Developers: Those who want to build custom pet behaviors using the provided SDK.
  • AI Power Users: Developers using AI coding agents who want a visual, non-intrusive way to monitor their agent's activity and reactions.

Highlights

  • MCP Support: Native integration with Claude Code, Cursor, and other MCP clients to drive pet reactions.
  • Sandboxed SDK: A secure plugin environment with a dedicated CLI for scaffolding, validating, and testing plugins.
  • Privacy-Centric: Local-only IPC, SSRF guards, and strict sanitization of AI-generated speech to prevent leaking secrets or code.
  • Extensive Official Plugins: Includes a variety of pre-made tools like a "Virtual Pet" (Tamagotchi-style), Focus Buddy, and Launch Buddy.

Related

  • Project
    nspady/google-calendar-mcp

    An MCP server that integrates Google Calendar with AI assistants, enabling them to manage schedules, detect cross-account conflicts, and create events from images or PDFs.

  • Project
    sentient-agi/EvoSkill

    A toolkit for automatically discovering and improving AI skills and prompts for coding agents, evolving general agents into specialists using benchmark-driven feedback.

  • Project
    RhythmicWave/NovelForge

    An AI-powered long-form fiction engine that uses schema-driven cards, knowledge graphs, and automated workflows to maintain consistency and structure in massive novels.

  • Project
    composio-community/secure-openclaw

    A personal 24/7 AI assistant that integrates Claude or Opencode with messaging platforms like WhatsApp and Telegram to provide tool access and persistent memory.