DSH Codex Pet is a community-maintained pet plugin for DeepSeek Harness (DSH), not an official OpenAI or DeepSeek AI product.

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.

Installation

Supported DeepSeek Harness versions: 0.1.0-rc.8, 0.1.1-rc.2, 0.1.2-rc.1, 0.1.5-rc.1, 0.1.5-rc.2, 0.1.6-alpha.1, 0.1.6-alpha.2, and 0.1.7-alpha.1. New compatibility is added without dropping these older releases. 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.

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

Known issue: in DSH 0.1.5-rc.2, stopping a task before the model starts responding may cause the pet to show a failure notification.

Create a custom pet

1. Open pet settings, click Create (创建), 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.

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.