Picks

web · repo · 2026-10-31 · GitHub

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

How its claims stand
  • Said here alone: 13

What it says

  1. 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.
  2. 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.
  3. 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.
  4. The command pnpm check runs the typecheck, the tests and the build. u20–21
  5. 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.
  6. 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.
  7. 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
  8. 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
  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.
  10. 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.
  11. 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.
  12. 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.
  13. 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
  1. 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?
    1. 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.
      1. question How to serve a team with least attention
      2. quote Least human attention, most value principle
      3. idea Proactive agent for one GitHub repository
        1. argument Restraint because team attention can be wasted
        2. mechanism Allowed requests become work items and replies
    2. 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.
      1. idea Setup is done with a coding agent
        1. action Ask your coding agent to read SETUP.md
      2. idea Nine numbered documents to read in order
    3. 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.
      1. tension Research prototype that may contain bugs
      2. surprise Coding agents did much of the engineering
      3. idea pnpm check runs typecheck, tests and build

The source, passage by passage

GitHub - deepseek-ai/dsh-superagent-prototype: Towards a More Autonomous Agent System
Illustration made with AI
  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. u6 Setup has many steps, so an agent does it with you. Ask your coding agent:
  7. u7 Read SETUP.md in this repository and set up dsh-superagent with me.
  8. u8 Read SETUP.md in this repository and set up dsh-superagent with me.
  9. 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.
  10. u10 Read the numbered documents in order; each builds only on the ones before it.
  11. u11 000 Philosophy
  12. u12 001 Domain model
  13. u13 002 Authorization
  14. u14 003 Execution
  15. u15 004 Prompts
  16. u16 005 Panel
  17. u17 006 Deployment: manual setup, configuration, upgrades and troubleshooting
  18. u18 007 Architecture
  19. u19 008 Cookbook: adding a Source
  20. u20 pnpm check runs the typecheck, the tests and the build.
  21. u21 pnpm check

The original

Around it

cordiverse/cordis: Meta-Framework of Spatiotemporal ComposabilityPlugin architectureGitHub - deepseek-ai/deepseek-harness: DeepSeek Harness: Everything is a Plugin.FrontierHarness EvalFrontier Harness EvalDeepSeek Super AgentDeepSeek HarnessDeepSeekCordisAgent harnesscoding agent setup with a coding agentproactive coding agentminimal human attention principledsh-superagentNEW DeepSeek Harness - Super Agent!GitHub - deepseek-ai/dsh-superagent-prototype: Towards a More Autonomous Agent SystemDeepSeek's dsh-superagent: a research…DeepSeek Super Agent, explained…dsh-superagentminimal human attention…proactive coding agentcoding agent setup with a…Agent harnessCordisDeepSeekDeepSeek HarnessDeepSeek Super AgentFrontier Harness EvalFrontierHarness Eval: nine agent…DeepSeek Harness: an open agent…Plugin architecturecordiverse/cordis: Meta-Framework…

source

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

topic

dsh-superagent

A research prototype of a proactive coding agent for one GitHub repository, packaged for DeepSeek Harness.

Topic1 sourceSingle source

topic

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

topic

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

topic

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