Configuration

All fields are optional and validated with a Schemastery schema (invalid values fail loudly at load). The user-editable fields (enabled, petScale, petId, hideWhenIdle) are exposed on the Web settings card.

Field	Default	Description
`enabled`	`true`	Master switch.
`alwaysOnTop`	`true`	Keep the pet above other windows.
`petScale`	`1`	Pet size, 0.5–4× in 0.25 steps.
`petId`	`text`	Which pet to display (a directory name under `assets/pets/`).
`hideWhenIdle`	`false`	Automatically hide the pet when it sleeps (no task), and show it again on activity.
`animationEnabled`	`true`	Run the frame animation (static frame when false).
`idleFrequencySec`	`20`	Seconds (≥8) between randomized idle variations.
`clickThrough`	`false`	Pass pointer events through (Windows only).
`startSleeping`	`false`	Start in the sleeping state.
`animationSpeed`	`1`	Global speed multiplier (0.25–4).

Example:

- insert:
    - id: desktop-pet
      name: dsh-desktop-pet
      config:
        petScale: 1
        petId: text
        idleFrequencySec: 30

Window position is persisted privately under ~/.dsh/desktop-pet/position.json (best-effort; failures are ignored). It does not depend on any Harness storage service.

Developer mode

When the core ctx.commands service is present, the plugin registers a /pet command to simulate states without any LLM:

/pet thinking
/pet working
/pet waiting_for_user
/pet success
/pet error
/pet reset

Valid states: STARTING IDLE THINKING WORKING CODING RUNNING_COMMAND WAITING_FOR_USER SUCCESS ERROR SLEEPING.

dsh-desktop-pet

AI 分析

安装

说明文档

Configuration

Developer mode