MIT-licensed pet gallery, CLI and desktop app: install an animated pet with `npx petdex install`, then connect your coding agent one-click in the desktop app so the pet reacts to every tool call.
DSH integration
Compatible
Inferred
Safety audit
Unaudited
Last verified
2026-08-21
License
MIT
01What can it help you accomplish?
Add an animated desktop pet that reacts to your coding agent's activity while you work with DeepSeek Harness
A pet floating above your workspace that animates on every tool call your agent makes, driven by activity hooks mapped to nine animation states
Developers running DeepSeek Harness (dsh) or other coding agents who want playful real-time visual feedback of agent activity
Browse, install and switch animated pets from the community gallery
Pet folders under ~/.petdex/pets/<slug>/ (pet.json + spritesheet) installed with one npx command; the active mascot is switched from the desktop app Settings
Coding-agent users who want to pick, install or switch community mascots without manual setup
02How to install into DeepSeek Harness
Prerequisites
- An npx-capable Node.js environment on PATH (the CLI is invoked as `npx petdex`)
- The desktop app downloaded from petdex.dev/download — it runs on macOS, Linux and Windows
Installation steps
- 01
Install a known pet: `npx petdex install <slug>` (README example: `npx petdex install boba`)
$ npx petdex install <slug>
- 02
Get the desktop app from petdex.dev/download (macOS, Linux and Windows)
- 03
Open it, press Cmd+, over the pet to open Settings, pick your pet under Pets, and connect your coding agents under Agents with one click each
Verify the integration
- After `npx petdex install boba`, you should see `~/.petdex/pets/boba/` with `pet.json` and a spritesheet
03DSH integration and capability boundaries
Standalone CLI + desktop mascot that floats an animated pet over your workspace and reacts to coding-agent activity via activity hooks; DeepSeek Harness is listed as a supported agent in the repo metadata/topics, while the README documents a generic one-click agent connection (dsh is not named in the README itself)
One-command pet install from the public gallery
a pet slug from the petdex.dev gallery→a pet folder at ~/.petdex/pets/<slug>/ containing pet.json and a spritesheet
writes pet files to ~/.petdex/pets on your machinedownloads pet assets from petdex.dev over the networkDesktop floater reacting to coding-agent activity
coding-agent activity hooks→a floating pet animating across nine state rows: idle, running-right, running-left, waving, jumping, failed, waiting, running and review
the desktop app runs an in-process Zig hook server bound to 127.0.0.1:7777Pet submission to the community gallery
a local pet folder (pet.json + spritesheet)→a submission reviewed and published to the petdex.dev gallery (`npx petdex submit ./my-pet/` or the web submitter)
authenticates via Clerk OAuth + PKCEuploads pet assets to cloud storage (zip → presigned R2)
04Who is it for? When not to use it?
Good for
- Developers running DeepSeek Harness (dsh) or other coding agents who want playful real-time visual feedback of agent activity
- Coding-agent users who want to pick, install or switch community mascots without manual setup
Not for
- Installing and submitting pets requires network access to petdex.dev — the manifest API serves every approved pet, submissions authenticate via Clerk OAuth + PKCE and upload assets to cloud storage — so offline use is not supported.
05Compatibility, maintenance and safety notes
- Installing and submitting pets requires network access to petdex.dev — the manifest API serves every approved pet, submissions authenticate via Clerk OAuth + PKCE and upload assets to cloud storage — so offline use is not supported.
- The floater experience requires the separate desktop app (macOS, Linux, Windows); the CLI alone only installs pet files, and the quick-start flow is centered on Codex, with other agents connected generically via the app's Agents settings.
- The README does not name DeepSeek Harness explicitly; DSH support is indicated by the repository's description ('for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more') and its dsh-plugin topic, while the README only documents a generic agent-hook connection.
MIT · actively maintained (latest release desktop-v0.8.0, 2026-08-14)
06Frequently asked questions
How does Petdex integrate with DeepSeek Harness?
The README documents a generic agent connection: open the desktop app's Settings (Cmd+,), pick a pet under Pets, and connect your coding agents under Agents with one click each. The pet then floats above your workspace and animates on every tool call. DeepSeek Harness is listed as a supported coding agent in the project's description and topics, though the README centers the flow on Codex and supported agents' activity hooks.
Is Petdex native to DeepSeek Harness or an MCP tool?
Neither. Petdex is an independent CLI plus desktop app. The desktop app runs an in-process Zig hook server on 127.0.0.1:7777 (no WebView or Node sidecar), and coding agents map their activity hooks to nine animation states. No MCP server is involved.
What do I need before installing?
An npx-capable Node.js environment for the CLI, and the desktop app downloaded from petdex.dev/download, which runs on macOS, Linux and Windows.
Where are pets installed, and how do I verify?
`npx petdex install <slug>` writes each pet to ~/.petdex/pets/<slug>/. The README's example says that after `npx petdex install boba` you should see ~/.petdex/pets/boba/ with pet.json and a spritesheet.
Where does my data go?
The pet catalog is fetched from petdex.dev's public manifest API. Submitting a pet authenticates through Clerk OAuth + PKCE and uploads your pet archive via a presigned R2 endpoint; the local hook server only listens on 127.0.0.1.
07Related DSH workflows
dsh-web
by zhu1090093659
DeepSeek Harness (DSH) Web Plugin Aggregation Ecosystem · Everything is a plugin, distributed via the Creative Workshop
j-space-cognition-suite-v3.7
by tiger3807861189
AI cognitive-enhancement skills for agent harnesses inspired by Anthropic's global workspace research. Adds inference-time control and reasoning tools for DeepSeek Harness, Claude Code, Codex and OpenCode.
dsh-deep-whale
by small-tailqwq
DSH Web GUI 鲸鱼娘主题皮肤（深海女仆工坊 maid-atelier：亮/暗双模式）
deepseek-balance-whale-widget
by meteornox
Floating cartoon whale widget living in the DSH Web UI corner that auto-loads, refreshes DeepSeek balance every 60s (click to refresh), with drag/snap, left-flip mirror, squish animation, size scaling and rolling-number animation
08Data and sources
Pick your pet under **Pets**, and connect your coding agents under **Agents** with one click each. No terminal involved.
Codex and the supported coding agents map their activity hooks to these states.
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.