MIT-licensed, local-first desktop pet platform with a plugin SDK; connects to DeepSeek Harness or any MCP client as a stdio/TCP MCP server so coding agents drive pet reactions locally.
DSH integration
Compatible
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-21
License
MIT
01What can it help you accomplish?
Give a coding agent a visible desktop companion that reacts to agent events
Local pet reaction animations (thinking, editing, testing, success, error), status changes, and short speech bubbles driven by MCP tools
Developers running coding agents such as DeepSeek Harness who want live, privacy-safe visual feedback while the agent works
Add focus timers, reminders and mini games to your workspace without any agent
Official plugins — focus timers, reminders, mood check-ins, mini games, launch shortcuts, hydration nudges, virtual-pet stats — enabled via the Control Center
Non-developer desktop users who want an animated companion with productivity plugins out of the box
Build custom pet abilities with a sandboxed plugin SDK
Custom plugins with permissions, quotas, storage, schedules, commands, panels, events, audio and notifications, scaffolded via `npx @open-pets/cli`
Plugin developers extending the OpenPets companion platform
02How to install into DeepSeek Harness
Prerequisites
- A desktop OS: macOS (Apple Silicon or Intel), Windows x64, or Linux (AppImage) — download the matching package from OpenPets Releases
- For agent integration: an MCP-capable coding agent configuration where the `@open-pets/mcp` server (run via npx) can be registered
Installation steps
- 01
Download the package for your operating system from OpenPets Releases: `OpenPets-*-mac-arm64.dmg` / `OpenPets-*-mac-x64.dmg` / `OpenPets-*-win-x64-setup.exe` / `OpenPets-*-linux-x86_64.AppImage`, and install it
- 02
Launch OpenPets — a pet appears immediately; no agent setup required
- 03
Optional: enable official plugins (focus timers, reminders, mini games) via the desktop Control Center
- 04
Optional: to drive pet reactions from a coding agent, add the `openpets` server (`"command": "npx"`, `"args": ["-y", "@open-pets/mcp@latest"]`, type stdio) to your agent's `mcpServers` configuration; pass `--pet <petId>` to target a specific pet
Verify the integration
- Launch the app and confirm a pet appears immediately on the desktop — no agent setup required
- Run `npx @open-pets/cli doctor` to check whether integrations are installed or broken and whether the desktop app is reachable (it exits non-zero only when an integration is broken)
03DSH integration and capability boundaries
Installed as a standard stdio/TCP MCP server (@open-pets/mcp); MCP-capable coding agents such as DeepSeek Harness drive desktop pet reactions via the openpets_status / openpets_react / openpets_say tools
Animated desktop pets
OpenPets desktop app (macOS / Windows / Linux)→animated companions that idle, wander and react on your desktop, managed via the built-in Pet Gallery
MCP server for agent-driven reactions
MCP client / coding agent configuration (stdio or TCP)→`openpets_status` (target pet ID + connectivity), `openpets_react` (reaction animations), `openpets_say` (speech bubble)
runs a local MCP server process; the Claude Code integration additionally writes memory instructions to `~/.claude/CLAUDE.md` and hooks to `~/.claude/settings.json`Official plugin catalog
built-in desktop Control Center→focus timers, reminders, mood check-ins, mini games, launch shortcuts, hydration nudges, and virtual-pet stats
plugins can show notifications, play audio tones and schedule remindersSandboxed plugin SDK v3
`@open-pets/plugin-sdk` JavaScript/TypeScript plugins→custom pet abilities with permissions, quotas, storage, schedules, commands, panels, events and audio
plugin network fetch requests are limited to developer-declared hostnames and guarded against local SSRF
04Who is it for? When not to use it?
Good for
- Developers running coding agents such as DeepSeek Harness who want live, privacy-safe visual feedback while the agent works
- Non-developer desktop users who want an animated companion with productivity plugins out of the box
- Plugin developers extending the OpenPets companion platform
Not for
- macOS builds may still be unsigned and can trigger a security warning; if macOS blocks execution you must remove the quarantine flag via `xattr -dr com.apple.quarantine /Applications/OpenPets.app`. Only Windows release installers are signed.
05Compatibility, maintenance and safety notes
- macOS builds may still be unsigned and can trigger a security warning; if macOS blocks execution you must remove the quarantine flag via `xattr -dr com.apple.quarantine /Applications/OpenPets.app`. Only Windows release installers are signed.
- Agent integration is per-client and must be configured separately: Claude Code installs MCP plus hooks and memory files, OpenCode installs a hook plugin, and Cursor / other MCP clients must register OpenPets as a stdio or TCP server; `npx @open-pets/cli doctor` diagnoses the Claude hook and Cursor MCP setups.
- OpenPets is local-first with no central AI server, but pets and plugins are fetched from the openpets.dev catalog (the app is fully functional without it), and any AI features run through connections you configure with your own keys.
MIT · actively maintained (latest release v3.4.0, 2026-08-09)
06Frequently asked questions
How do I connect DeepSeek Harness or another coding agent to OpenPets?
Register OpenPets as a standard stdio or TCP MCP server in your agent's MCP configuration, e.g. `npx -y @open-pets/mcp@latest`. The agent then gets `openpets_status`, `openpets_react` and `openpets_say` tools to check connectivity, trigger animations (thinking, editing, testing, success, error) and display speech bubbles. Pass `--pet <petId>` to target a specific pet.
Do I need an agent to use OpenPets?
No. Download the latest desktop release and launch it — a pet appears immediately with no agent setup required. Official plugins (focus timers, reminders, mood check-ins, mini games, virtual-pet stats) can be enabled via the desktop Control Center.
Will my prompts or code show up in the pet's speech bubbles?
No. Speech content is validated to prevent leaking sensitive variables, paths, secrets or multiline code snippets, and all automated reactions run on static local triggers such as a command running or a file being written.
Which platforms are supported?
macOS (Apple Silicon and Intel dmg), a signed Windows x64 installer, and a Linux AppImage. macOS builds may still be unsigned; if macOS blocks execution, run `xattr -dr com.apple.quarantine /Applications/OpenPets.app`.
Does OpenPets send my data to a cloud server?
There is no central AI server — AI features run through connections you configure with your own keys on your machine, and IPC uses a local socket secured with a per-run random token. Pets and plugins are fetched from openpets.dev, but the app is fully functional without it.
07Related DSH workflows
dsh-better-sidebar
by omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
dsh-tui
by ccch1mneyyy
Claude Code 风格全屏终端 TUI：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、上下文进度条 + TPS 仪表；接入 Agent preset（standard/code/minimal/cordis）、Skills、MCP、Goals、Todos、子代理，/ 命令注册表与随附技能（audit/bug/review/practice/pr_comments/release-notes/vuln-check）；纯插件挂载零核心改动。
dsh-tianshu-tui
by huiliyi37
DeepSeek Harness 交互式终端 UI 插件：会话工作区、图片端到端（剪贴板/视觉桥）、slash 下拉、审批卡片、推理可视化，纯展示层
dsh-popout-sidebar
by e2mcc
A sidebar can pop out a separate browser tab (drag it to another monitor)
08Data and sources
To run OpenPets as an MCP tool, add the server to your agent's configuration:
**Cursor / Other MCP Clients**: Register OpenPets as a standard stdio or TCP MCP server.
**Optional agent layer**: Claude Code, OpenCode, Cursor, Pi, and MCP clients can drive local pet reactions without expos…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.