playpets

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Pet friends that live on your desktop. Four come with the app and any Codex pet can join: up to 12 chat with each other through the AI you pick, garden and fish in their yard, and cheer on Claude Code, Codex, Gemini CLI and Cursor. Free and open source for macOS, Windows and Linux.

README.md

Banner: a yard where your pets talk to each other

PlayPets

Pet friends that live on your desktop: four come with the app, any Codex pet can join them, and up to 12 talk to each other and cheer on your coding agent.

Latest release
Downloads
License: MIT
macOS · Windows · Linux

Download for macOS
Get it from Microsoft Store
Download the Windows installer
Download for Linux

Website · User guide · Install guide · Releases · Developer docs

Site in: English · Korean · Japanese · Simplified Chinese

Four friends dig up a find and catch a fish in the yard, then watch a show light up the night sky

Why PlayPets

  • 🐾 Reads Codex pet files (the custom pets made for ChatGPT and Codex) as they are: every action, and the sixteen look directions when the sheet has them. Codex is not needed.
  • 👥 Up to 12 friends at once, in the yard and out on your desktop, one by one, with gifts, flowers and trees from the yard to decorate it. Keep your pet in the ChatGPT desktop app too: both read the same pet files.
  • 💬 They chat with you, and with each other, through the AI you pick.
  • 🧑‍💻 They react to Claude Code, Codex, Gemini CLI, Cursor, Grok Build, Qoder, Kimi Code and other MCP tools.
  • 🏡 A yard of their own: Hill garden, Wild garden, Lakeside cottage, Garden workshop or your own backgrounds, gifts like a swing or a pond, four games (one only in winter), a garden, fishing and a 203-entry album.
  • 🌱 The four starter pets also dig, plant, fish and change clothes with the seasons.
  • 🔓 Free and open source (MIT) for macOS, Windows and Linux.
Friends talk among themselves Out on your desktop while you code A friend for each coding agent
Four friends in the yard, chatting in speech bubbles Four friends on the desktop below a terminal running tests Coding tools settings with a reacting friend chosen for each agent

Features

Area What you get
Companions Daisy, Clover (main mascot), Pip and Miso, with summer and winter outfits; or community pet files
Relationships Friend, Partner, Dependable mentor, Playful younger sibling
Conversations Chat with one friend, bring others in, or let them talk among themselves
AI connections Signed-in Claude Code or Codex CLI, local Ollama, an OpenAI or Grok (xAI) API key, or an OpenAI-compatible server; one AI per friend
Places Hill garden, Wild garden, Lakeside cottage, Garden workshop and imported backgrounds; season, time and weather controls
Play Hide and seek, parade, tag and, in winter, a snowman
Garden and album Dig for seeds, saplings and keepsakes; plant; fish and catch bugs; fill a 203-entry album
Desktop mode Send friends, gifts, flowers and trees out one by one from their right-click menu; friends stroll and visit them (on macOS, over full-screen apps too)
Coding company Hooks and MCP for Claude Code, Codex, Gemini CLI, Cursor, Grok Build, Qoder, Kimi Code and other MCP tools
Languages English, Korean, Japanese, Simplified Chinese

More in the user guide: chat and AI billing, the yard and its games, the desktop, importing community pets and the character and background studios.

Install

System Get it
macOS (Apple Silicon and Intel) PlayPets_<version>_macos-universal.dmg from releases, or Homebrew (below)
Windows x64 / ARM Microsoft Store or winget (below), or PlayPets_<version>_windows-x64-setup.exe / …_windows-arm64-setup.exe from releases
Linux x64 / arm64 .deb (Debian, Ubuntu) or .AppImage (needs FUSE 2)
# macOS
brew install gaerae/tap/playpets
# Windows
winget install --id 9NSKXQ6R187M --source msstore
  • From 1.3.0 the macOS app is signed and notarized. The Windows installer from GitHub is not code-signed yet, so SmartScreen may warn (how to install it through the warning); the Microsoft Store and winget packages are signed by Microsoft.
  • The install guide covers those warnings and Linux notes.
  • The Microsoft Store package needs Windows 10 version 2004 or later.
  • To build from source, see Development.

Getting started

  1. Open Friends & settings → Invite a friend and pick Daisy, Clover, Pip or Miso.
  2. Connect an AI in Settings → Friends & AI.
    • Installed Claude Code and Codex are found automatically.
    • Ollama and OpenAI-compatible servers need a model name; a compatible server also needs its address, and an API key only if it asks for one.
  3. Click a friend's name tag to chat.
  4. In Friend settings, choose a personality, a relationship and what the friend calls you.
  5. Optional: add your coding tool's hooks from Settings → Coding tools.

Coding agent integration

  • In Settings → Coding tools, press Connect: PlayPets asks, then adds its hook to that tool's settings file and keeps a backup beside it.
  • Disconnect takes out only PlayPets' entries; Copy settings still gives the snippet to paste yourself.
  • No Node.js needed: the app binary is the integration command.
Tool Where to paste What it does
Claude Code (recommended) ~/.claude/settings.json Reports every step through hooks
Codex CLI ~/.codex/config.toml, at the top A note when a turn ends
Gemini CLI ~/.gemini/settings.json Reports every step through hooks
Cursor ~/.cursor/hooks.json Reports edits, commands and completion (observe-only hooks)
Grok Build ~/.grok/hooks/playpets.json, a new file Reports every step through hooks
Qoder ~/.qoder/settings.json Reports every step through hooks
Kimi Code ~/.kimi-code/config.toml, at the end Reports every step through hooks
Other MCP tools The tool's MCP settings set_pet_state, say, react, list_pets
Terminal commands
playpets hook claude|gemini|cursor|grok|qoder|kimi   # hooks (stdin JSON, always exit code 0; prints {} for Gemini and Cursor)
playpets hook codex <json>      # Codex notify
playpets mcp                    # MCP stdio server
playpets status <state> [message]   [--pet name|ID] [--bridge file]
playpets say <message>
playpets react <action>
playpets pets
playpets run -- <command>

[!NOTE]

  • The bridge stays on this computer: 127.0.0.1, with token authentication.
  • Hooks leave out your prompts and tool inputs.
  • Short completion and notification reports can still hold work details, including code in an agent's answer. They can reach your chosen AI provider in a friend's conversation.
  • Review terminal and MCP messages before sending. Use a local model to keep those details on this computer.

Privacy, updates and languages

  • Pets and settings stay in a data folder on your computer (data folder); API keys go only to the system's secure storage.
  • Conversations stay in memory and are gone when the app quits. See the privacy policy.
  • The app looks for updates on its own and installs one only when you choose; each is checked against the updater signing key. The Store version updates through the Store (app updates).
  • English, Korean, Japanese and Simplified Chinese, following the system language; change it in Settings → Language & startup.

Development

  • Needs Rust stable 1.99+, Node.js 26.12.1+ and the Tauri prerequisites.
  • First setup and running the app: Set up a development environment.
  • pnpm install --frozen-lockfile, then pnpm test and pnpm run lint; pnpm run test:e2e runs the real app.
  • Architecture, standards, every command and workflow, and the repository map: developer docs.

Contributing

License

  • MIT (LICENSE), including the pet mascot art in assets/.
  • Imported community pets belong to their creators; the source is saved with each in pet.json.

Trademarks

  • PlayPets is not affiliated with or endorsed by OpenAI.
  • ChatGPT and Codex are trademarks of OpenAI. Claude, Gemini, Cursor, Grok and Ollama are trademarks of their companies.
  • PlayPets only reads the Codex pet file format.

Yorumlar (0)

Sonuc bulunamadi