DeepSeek's dsh-superagent: a research prototype of a proactive coding agent
The source's own title: GitHub - deepseek-ai/dsh-superagent-prototype: Towards a More Autonomous Agent System
It acts only when asked or allowed, on one GitHub repository, and is packaged as a plugin for DeepSeek Harness.
Article
- Said here alone: 13
What it says
- dsh-superagent is a research prototype from the DeepSeek team: a proactive coding agent for one GitHub repository, packaged for DeepSeek Harness. It listens to GitHub and optionally Feishu, opens a work item when an allowed person asks, works in its own session and directory, and answers in the original conversation, for example with a pull request. Its guiding principle is to take as little human attention as possible while giving as much value as possible. The page says the code is not production-ready, and it describes setup done with a coding agent following SETUP.md, the numbered documentation, and the pnpm check command.
- When an allowed person asks for work, dsh-superagent 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. u4 The pull request is given as one example of an answer, not the only form.
- The documentation consists of nine numbered documents, from 000 Philosophy to 008 Cookbook, which the reader should read in order because each builds on the ones before it. u10–19 The list runs from 000 to 008, which gives nine documents.
- The command pnpm check runs the typecheck, the tests and the build. u20–21
- Set up dsh-superagent by asking one's own coding agent to read SETUP.md in the repository and do the setup together with the user. u6–8 Addressed to operators who will install the tool.
- The agent acts only on request or under a team rule, because an agent that can act for a whole team can also waste a whole team's attention. u5 This explains why restraint is built into the agent's design, not just its settings.
- dsh-superagent is a proactive coding agent for one GitHub repository, packaged as a bundle for DeepSeek Harness. It listens to GitHub and optionally Feishu, and it acts only when asked or when a team rule allows. u4–5
- Setup is meant to be done with a coding agent: the agent asks one short question at a time, shows the full plan once, and then installs and configures everything by following SETUP.md. u6–9
- How can a proactive coding agent serve a whole team while taking as little human attention as possible and giving as much value as possible? u5 The source states the principle but does not fully answer this question in the page itself; it points to docs/000-philosophy.md.
- The principle the agent is built around: take as little human attention as possible and give as much value as possible. u5 It states the project's guiding principle in one line.
- Much of the prototype's engineering was done by coding agents, not only by people. u1–2 A reader might expect a team's own research code to be written by its engineers alone.
- The code is a research prototype that may still contain bugs and has inconsistent style, and it is not identical to the internal version or the article's implementation, so some designs in the article are future directions only. u1–3 The source warns readers to review and adapt the code before using it in their own environment.
- dsh-superagent is a proactive coding agent for one GitHub repository that acts only when asked or when a team rule allows, and it speaks only when someone must act or can use a result. How can a proactive coding agent serve a whole team while taking as little human attention as possible and giving as much value as possible?
How it argues
- thesis A proactive team coding agent that acts only when asked How can a proactive coding agent serve a whole team while taking as little human attention as possible and giving as much value as possible?
- theme Acting only when asked or allowed The agent works only on request or under a team rule, because a team's attention is the scarce resource it must protect.
- theme Setup done by a coding agent Installation is meant to be done by the user's own coding agent, following the repository's SETUP.md through a short guided dialogue and nine ordered documents.
- theme Prototype status and caveats The source is a research prototype that may be buggy and inconsistent, with some article designs being future directions only.
The source, passage by passage
- u1 Research prototype for reference only, not an official DeepSeek product. This code grew out of our team's day-to-day development work, with much of the engineering done by coding agents. Treat it as research code, not production-ready software. It may still contain bugs, and its coding style and engineering practices may be inconsistent. Review and adapt it before using it in your own environment. We have adapted it for publication, so it is not identical to our internal version or the implementation described in Exploring Super-agent Design: Towards a More Autonomous Agent System. Some designs discussed in the article are directions for future development and are not implemented in this prototype.
- u2 Research prototype for reference only, not an official DeepSeek product. This code grew out of our team's day-to-day development work, with much of the engineering done by coding agents. Treat it as research code, not production-ready software. It may still contain bugs, and its coding style and engineering practices may be inconsistent. Review and adapt it before using it in your own environment.
- u3 We have adapted it for publication, so it is not identical to our internal version or the implementation described in Exploring Super-agent Design: Towards a More Autonomous Agent System. Some designs discussed in the article are directions for future development and are not implemented in this prototype.
- u4 dsh-superagent is a proactive coding agent for one GitHub repository, packaged as a bundle for DeepSeek Harness. It listens to GitHub and, optionally, Feishu. When someone allowed asks the agent 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 web panel shows what needs a person.
- u5 It is also a way of working with an agent: take as little human attention as possible, and give as much value as possible. An agent that can act for a whole team can also waste a whole team's attention, so it 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. docs/000-philosophy.md explains the principle and what it asks of the operator.
- u6 Setup has many steps, so an agent does it with you. Ask your coding agent:
- u7 Read SETUP.md in this repository and set up dsh-superagent with me.
- u8 Read SETUP.md in this repository and set up dsh-superagent with me.
- u9 It asks one short question at a time, shows the full plan once, and then installs and configures everything. SETUP.md is what it follows.
- u10 Read the numbered documents in order; each builds only on the ones before it.
- u11 000 Philosophy
- u12 001 Domain model
- u13 002 Authorization
- u14 003 Execution
- u15 004 Prompts
- u16 005 Panel
- u17 006 Deployment: manual setup, configuration, upgrades and troubleshooting
- u18 007 Architecture
- u19 008 Cookbook: adding a Source
- u20 pnpm check runs the typecheck, the tests and the build.
- u21 pnpm check
Around it
NEW DeepSeek Harness - Super Agent!
DeepSeek Super Agent turns GitHub and Feishu requests into autonomous work sessions using plugins and configuration rather than a fork of DeepSeek Harness. Its design illustrates how harness architecture can shape agent capabilities, efficiency and cost, although the release remains a prototype with preliminary tests and unresolved security issues.
Video
dsh-superagent
A research prototype of a proactive coding agent for one GitHub repository, packaged for DeepSeek Harness.
Topic1 sourceSingle source
minimal human attention principle
The design principle that an automated agent should consume as little human attention as possible while delivering as much value as possible.
Topic1 sourceSingle source
proactive coding agent
A coding agent that takes initiative on work rather than only responding to direct instructions, here limited to acting when asked or allowed.
Topic1 sourceSingle source
coding agent setup with a coding agent
An approach in which a coding agent installs and configures a tool by following the repository's setup documentation together with the user.
Topic1 sourceSingle source
This text is written with AI.
Placed in: Now