dsh-codex-pet

DSH Codex Pet

A little companion for your DeepSeek Harness tasks

简体中文 · Changelog · Apache-2.0

DSH Codex Pet is a community-maintained pet plugin for DeepSeek Harness (DSH), not an official OpenAI or DeepSeek AI product. From 1.0.1 it supports DSH 0.2.0-rc.1, 0.2.0-rc.2, 0.2.1-rc.1, 0.2.1-rc.2, and 0.2.1-rc.3. Earlier hosts and the 0.2.1 alphas are rejected by the version gate, so the plugin will not run; local pet settings and custom pets are not deleted.

Features

Keep a companion nearby while you work in DSH, follow task progress, and handle requests that need your attention. Choose a built-in pet or create your own with a Skill.

• Nine built-in pets: choose a companion and adjust its size in pet settings. Assets are bundled locally.
• In-page companion: keep a companion in DSH Web. Floating desktop pets require a desktop app with pet support.
• Multiple tasks at a glance: follow running tasks, completion, errors, and requests that need your attention. An empty notification list leaves only the pet visible.
• Act from the notification: open the associated task, stop its current turn, or handle supported approval, question, and plan requests.
• Quiet when you need it: dismiss an individual reminder without stopping its task; collapse or restore the pet through its menu or settings.
• Create your own companion: describe a pet in settings and start a dedicated DSH task using the bundled hatch-pet Skill.
• Small interactions: drag to move, double-click to jump, and right-click for the pet menu.

Screenshots

Multiple task notifications

See running tasks beside your companion, with separate controls to open the conversation, stop its current turn, or dismiss its reminder.

Pet settings

Choose from the nine built-in pets, access the custom pet directory, and adjust the pet size.

A companion in your conversation

Keep working in DSH while the pet and task notifications remain in the corner of the page.

DSH product ecosystem

For a desktop workbench, download DSH Codex Desktop. Existing DeepSeek Harness installations can add plugins as needed by following each project's README. Below are 11 first-party plugins; consult the corresponding desktop release notes and bundled catalog for what that version includes.

Plugin · What you can do Codex UI · Organize projects and conversations, search tasks, and navigate chat turns Agency Agents · Choose and summon specialists for your task Skills Manager · Find, enable, create, and import local skills Archive Manager · Search, restore, or clean up archived conversations IM Connect · Send tasks and receive replies through messaging platforms Automation · Schedule tasks and review each run BTW · Ask side questions without interrupting the main task Simplify · Use /simplify to improve code within your Git changes PUA · Guide the Agent to try new approaches after failures, investigate causes, and verify results before completion Code Review · Use /review to request an independent Agent code review and receive the report in the current conversation Codex Pet · View conversation notifications and respond to tool approvals and questions through a desktop pet

Installation

Supported DeepSeek Harness versions: `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`, `0.2.1-rc.2`, and `0.2.1-rc.3`. Hosts before 0.2.0 (including the previously supported 0.1.2-rc.1, 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-rc.1, and 0.1.7-rc.2) and 0.2.1-alpha.1 through 0.2.1-alpha.5 are rejected by the version gate, and the plugin will not run. If you still use one of those hosts, install @michengai/dsh-codex-pet@0.1.19 instead of @latest. The version gate only refuses to load the plugin. It does not delete pet selection, position, or custom pets under DSH_HOME/codex-pet. Make sure the dsh command is available. The example uses the web profile; replace it with your target profile.

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://registry.npmjs.org/ --ignore-scripts

Restart DSH after installation, then open Settings → Pets.

Usage

Open Settings → Pets (宠物 in the current UI), or open settings from the pet's right-click menu.

Goal · Action Pick a companion · Select a pet in settings and adjust its size. Move or play · Drag the pet to move it; double-click to jump. Read task updates · Read the notification bubbles; expand the list when several tasks need attention. Continue a conversation · Click its notification or reply control to open the corresponding DSH task. Handle a request · Open the request details and answer the supported approval, question, or plan prompt. Stop a task turn · Click the stop control on that running task's notification. Dismiss a reminder · Click its close control. The task continues running. Hide or restore the pet · Use the right-click menu or pet settings.

The pet is a notification and action surface. Start new conversations and write follow-up messages in the main DSH interface.

Create a custom pet

1. Open pet settings, click the + icon (创建), and describe the companion.
2. Click Create in DSH (在 DSH 中创建). The plugin opens a dedicated task and sends the bundled Skill instructions.
3. Follow that task's progress. Creation uses DSH's configured model and image tools.
4. Once the pet files are saved, refresh the pet library and select the new companion.

Creating pets requires an image-generation tool configured in DSH.

Updates and uninstallation

Use Settings → Pets → Check for updates. If automatic installation is unavailable, copy the update command shown in the dialog. Wait for running tasks to finish, then update and restart DSH as prompted.

To uninstall:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

dsh plugin --profile web remove @michengai/dsh-codex-pet

Custom pets are stored in .dsh/codex-pet/pets under your user directory by default; open the folder from pet settings. If DSH_HOME is set, pets are stored in its codex-pet/pets folder. Uninstalling keeps those files and settings.

Contributing

See the development and validation guide (Chinese) for local development, testing, and release procedures. GitHub and npm both include a ready-to-run lib; after changing source, run npm run build before committing.

License

Original plugin code is licensed under Apache License 2.0. Bundled pet artwork originates from OpenAI Codex and is excluded from this project's Apache-2.0 license grant; see NOTICE.