Import Codex-style sprite-sheet pets and render them as a floating shell.overlay with a pet library, interactions, and agent-state linkage.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-codex-pet
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:skr311/dsh-codex-pet#path:/packages/dsh-codex-pet
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
A desktop pet plugin for DeepSeek Harness (DSH): import Codex-style sprite-sheet pets and render them in the DSH Web GUI as a floating shell.overlay — with a pet library, interactions, and live Agent-state linkage.
Install
dsh plugin --profile web add dsh-codex-pet
Then restart the DSH Web GUI (host-side change) and refresh the page. Upload your own pet zip (see the asset format below) in Settings → Pet Library.
Compatibility
- Node.js:
>=20 - Confirmed compatible DSH release:
0.1.5-rc.2 - See
dsh.compatibility.dshReleasesinpackage.jsonfor exact per-release status.
Features
- Sprite-sheet (Format A) sequence playback: per-frame ms timing, row = animation.
- Draggable floating overlay, click to wave, idle random antics, dark/light theme (all
--dsw-*tokens). - Pet library: zip upload / URL import / enable / disable / delete / preview.
- Agent-state linkage: working → run; approval/question → waiting; task done → happy; task failed → sad.
Asset format (Format A)
zip = pet.json + spritesheet.webp (192×208 frame, 8 columns, row = animation). See the full spec in the repository docs.
Docs
- Repo: https://github.com/skr311/dsh-codex-pet (README / README_EN / docs, Chinese primary)
License
MIT
Links
More in this category
PC2005-cloud/dsh-pet#dsh-pet★ 832
Desktop pet for the DSH Web UI with 25 transparent animations, screen wandering, click reactions and drag, plus a reproducible asset-generation pipeline.
Nagi-ovo/dsh-ads★ 636
Parody ads in 2005-Chinese-web style: sidebar banners, in-chat feeds, corner popups, and a close button whose hit area is smaller than it looks. All fictional.
vlln/whale-girl★ 338
Desktop pet (QQ-pet style): floats in the corner, draggable, feedable, playable.
a86582751/dsh-nexttavern★ 119
Roleplay workspace for DeepSeek Harness: import SillyTavern/TauriTavern character cards or author one from scratch through an interactive flow; turn a long TXT novel into a playable card with either an intensive or a coarse reading pass; the main agent consults worldbooks on demand, and prose is read in a dedicated tavern reader tab; explore multiple worldlines inside one conversation (regenerate, edit-and-send, explicit clone); scoped style presets with 16 built-in styles, a character agent cluster, a standalone decision card, and card or novel export; long stories hold together through a frozen settings prefix, a hard-cut context window, traceable director notes and keyword/semantic/hybrid recall, with embeddings either online or fully local. Targets Harness 0.1.2-alpha.3 and applies its documented compatibility patches.
yyh-001/dsh-meme★ 112
Chat meme stickers: text-only send, mood auto-send, QQ/WeChat-style picker, auto-learn, custom packs.
Sutera-Diffusus/dsh-whale-musume★ 89
A whale-girl desktop pet for the DeepSeek Harness Web UI: pat-to-raise growth, work-state poses per tool type, 494 dialogue lines, 30 achievements, a growth diary, drag physics, theme sync and an accessibility mode. Chat-keyword sensing and API-balance care ship off and are opt-in; an optional weather mood calls Open-Meteo only after you name a city. No telemetry.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.