dsh-superagent-desktop

dsh-superagent-desktop

Desktop bundle packaging of the official dsh-superagent research prototype (MIT). This fork turns it into a bundle that installs into an existing DeepSeek Harness profile — no second process, no separate profile, no manual token URL. It is not an official DeepSeek product; treat it as research code.

dsh-superagent-desktop is a proactive coding agent for one GitHub repository. It listens to GitHub and, optionally, Feishu. When a person it is allowed to serve asks for work, it opens a work item, works on it in its own agent Session and directory, and answers in the original conversation — for example with a pull request. A panel in the sidebar shows what needs a person.

The design principle is upstream's: take as little human attention as possible, and give as much value as possible. The agent acts only when asked or when a rule the team wrote allows it, and speaks only when someone must act or can use a result. See docs/000-philosophy.md.

Requirements

• DeepSeek Harness ^0.2.1-alpha.2 || ^0.2.2-rc.1 (developed and tested against desktop 0.2.2-rc.1 on Windows 11; earlier prototype docs target macOS/Linux).
• git 2.32 or later, and gh (GitHub CLI) for the GitHub Source.
• One GitHub repository you can grant a token or app access to. Feishu is optional and needs lark-cli.

Install

From the Harness UI. Settings → Plugins → Add bundle, enter dsh-superagent-desktop, then enable it. Restart the app.

From the CLI. In the profile that should run the agent:

dsh plugin --profile desktop add dsh-superagent-desktop

then add "dsh-superagent-desktop" to dsh.profile.bundles in that profile's package.json and restart. For a local checkout, use the checkout path instead of the version:

dsh plugin --profile desktop add "link:/absolute/path/to/dsh-superagent"

After restart a hammer icon appears in the sidebar. Open it and complete Machine configuration (repository, agent account, Feishu if you use it).

State directory

The machine state defaults to <DSH_HOME>/state/superagent (DSH_HOME defaults to ~/.dsh), so a fresh install needs no configuration. The directory is locked while a host runs: two host processes must not share one state directory. To give this profile its own, override it in the profile's cordis.patch.yml:

- id: dsh-superagent
  config:
    stateDir: /absolute/path/to/state/superagent

stateDir is also editable from the panel's machine configuration when the client config form is available.

What is in the bundle

• The dsh-superagent host plugin (Sources, Tickets, authorization, executor Sessions) and its GitHub and optional Feishu watchers.
• The management panel: sidebar icon, full-page panel, and the Plugin Manager configuration view.
• Two agent presets (worker and router) that its sessions run under.
• The upstream documentation in docs/ and the agent-guided setup in SETUP.md.

Setup, upgrades, troubleshooting

The upstream documents apply unchanged; start with docs/006-deployment.md. Note that the profile name in those commands is the profile you installed into (desktop here), and that stateDir is now optional. SETUP.md walks an agent through first-time configuration.

To upgrade, update the package (or git pull && pnpm install && pnpm build for a checkout) and restart the host.

Development

pnpm install
pnpm build      # tsdown: writes lib/
pnpm check      # typecheck, tests, build

The upstream test suite assumes POSIX utilities (sleep, ps) and a POSIX process model, so on Windows pnpm test reports failures that come from the platform rather than from this bundle. pnpm build and pnpm typecheck are platform-neutral, and the live checks are the panel and the API of the running host.

License and provenance

MIT, see LICENSE. This package is a fork of the DeepSeek Harness team's dsh-superagent research prototype; the original copyright and MIT terms are preserved. Changes in this fork: desktop-bundle packaging, a default stateDir, peer ranges widened to 0.2.x releases, and Windows compatibility fixes in the host code.