OPEN SOURCE · RESEARCH PROTOTYPE

A LITTLE LESS BUSYWORK. A LITTLE MORE BUILDING.

DeepSeek
SuperAgent

Explore the Open-Source Autonomous AI Coding Agent

Discover how DeepSeek SuperAgent explores autonomous software development through AI-powered coding workflows, GitHub integration, task execution, and human review.

Research code. Human judgment included.

CONCEPTUAL WORKFLOW
Assign a taskA request from an allowed contributor
DeepSeek SuperAgentContext → execution → delivery
project context⌘

01context.read(repository)

02agent.work(task)

03human.review(changes)

Read project contextWork in a dedicated sessionPrepare changes for review
Review the resultA reply or pull request, back in GitHub
HUMAN IN THE LOOP

An illustration of the workflow, not a live product interface.

MIT licensedSource availableBuilt around human review
Explore the project

Watch DeepSeek SuperAgent in action

Explore DeepSeek SuperAgent’s design, practical setup and limitations in this independent video by AICodeKing.

I Tried Deepseek's New SuperAgent Harness... Is IT ANY GOOD?

AICodeKing explores DeepSeek SuperAgent’s Router and Workers, triggers, Chain of Recall and Watchdog, then discusses practical setup and the research prototype’s limitations.

View on YouTube

YouTube loads only when you choose to play. Playback connects to YouTube.

Understand the workflow. Inspect the source. Review the changes.

What is DeepSeek SuperAgent?

An agent that works where your team already builds.

DeepSeek SuperAgent is the name used here for dsh-superagent, an open-source research prototype published in the deepseek-ai GitHub organization. It is a proactive coding-agent bundle for DeepSeek Harness, designed to work with one GitHub repository.

It turns authorized requests into work items, gives each item its own agent session and working directory, and brings a result back to the original conversation. Depending on the task, that result may include a pull request. An optional Feishu source connects team chats.

It is intended for developers and teams exploring agent-assisted maintenance, issue handling, and code changes. The maintainers explicitly say it is not an official DeepSeek product or production-ready software. Some ideas in the associated research article are future directions, not implemented features.

Read the original README

A coding workflow, connected.

Key features of DeepSeek SuperAgent

Capabilities described in the project README and deployment guide. This is experimental software; task outcomes depend on configuration, context, and review.

01

Autonomous coding

Authorized work is assigned to an agent session with its own directory. The agent attempts the requested changes using the configured model and execution environment.

02

GitHub integration

A dedicated GitHub account listens for notifications and delivers results to the original thread. The prototype targets one repository on github.com.

03

Issue handling

An allowed contributor can mention the agent in an issue or comment to request work. Policies and allowed lists determine which requests become tickets.

04

Pull request workflow

The agent can return a pull request for code changes. Commit identity, delivery instructions, and optional merge conditions are configured by the operator.

05

Task execution

Tickets run in separate sessions and prepared working directories. The operator configures the checkout preparation, model, worker limits, and blocked commands.

06

Human review

A web panel surfaces setup requirements and work needing attention. People inspect the output, resolve problems, and decide whether changes should be merged.

DOCUMENTED IN THE PROTOTYPE

How does DeepSeek SuperAgent work?

Four steps, with a developer in control. This is a conceptual summary of the documented workflow, not a promise that every task succeeds.

  1. 01

    Assign a task

    An allowed contributor mentions the agent in a GitHub issue or comment with a concrete request.

  2. 02

    Analyze the project

    The request becomes a ticket. A dedicated session receives the task and prepared project context.

  3. 03

    Execute the task

    The agent attempts the work in its own directory, using the configured tools and instructions.

  4. 04

    Review the changes

    The result returns to the conversation. A developer reviews the reply, code changes, or pull request.

Authorization first. Isolated work directories. Human decisions at the end.

From curious to hands-on.

How to get started with DeepSeek SuperAgent

The official README recommends an agent-guided setup. Start with the source, then let SETUP.md guide the environment and account configuration.

BEFORE YOU START
  • Node.js 22.19+ or 24+ and pnpm
  • Git 2.32+, Python 3.8+, and tmux
  • GitHub CLI 2.48+ and an agent account with repository write access
  • DeepSeek Harness with a configured model provider
Read the full setup guideManual installation & configuration

The commands below are an introduction, not a complete unattended installer. Profile creation is for new installations only; recreating an existing profile replaces its configuration. Follow the upstream guide before running commands.

01

Get the source

Clone the original repository and enter its working directory.

TERMINAL
git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent
cd dsh-superagent
02

Use the recommended guided setup

Give this exact prompt to your coding agent from the checkout. SETUP.md collects your repository, account, authorization, and execution choices before installing anything.

AGENT PROMPT
Read SETUP.md in this repository and set up dsh-superagent with me.
03

Install the runtime and dependencies

For a manual setup, the deployment guide pins this public Harness release, then installs and builds the bundle. Follow the full guide for profile creation and plugin registration.

TERMINAL
npm install -g @deepseek-ai/[email protected]
pnpm install && pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"
04

Configure, then start

Before starting, follow the guide to create a separate Harness profile, configure cordis.patch.yml with real paths, and authenticate the agent account. Then start and inspect the service; complete Sources, Policy, Execution, and Prompts in its panel.

TERMINAL
scripts/dsh-superagent start
scripts/dsh-superagent status

Based on the official README, SETUP.md, and deployment guide · checked November 3, 2026

Read the code. Make up your own mind.

Explore the open-source project, follow its design decisions, and use the original documentation as your source of truth.

Explore the repository
deepseek-ai /
dsh-superagent-prototype

Towards a more autonomous agent system. A research prototype for reference, published by deepseek-ai.

Research prototype · Not an official DeepSeek product

Frequently asked questions

The essentials, with answers grounded in the original project documentation.

01

What is DeepSeek SuperAgent?

It is the name used on this website for dsh-superagent: an open-source, proactive coding-agent research prototype for DeepSeek Harness. It turns authorized requests for one GitHub repository into tickets, works in dedicated sessions, and replies in the original conversation.

02

Is DeepSeek SuperAgent open source?

Yes. The dsh-superagent-prototype repository is publicly available in the deepseek-ai GitHub organization under the MIT License. Check the repository's LICENSE file for the exact terms.

03

Is DeepSeek SuperAgent an official DeepSeek product?

No. Although the repository is published under deepseek-ai, its README explicitly calls it a research prototype for reference only, not an official DeepSeek product. This website is also an independent informational resource with no affiliation or official endorsement.

04

What can DeepSeek SuperAgent do?

The documented prototype receives authorized GitHub requests, creates work tickets, runs coding sessions in dedicated directories, and delivers results such as replies or pull requests. Feishu integration is optional. Capabilities described as future research directions should not be assumed to exist in the prototype.

05

How does DeepSeek SuperAgent work?

A source receives a request, authorization policies decide whether it can become work, and an executor works on the ticket in its own agent session. The result is returned to the original thread, while a web panel shows setup requirements, status, and work needing human attention.

06

How do I install DeepSeek SuperAgent?

Clone the repository and ask your coding agent: Read SETUP.md in this repository and set up dsh-superagent with me. That is the README's recommended path. Manual installation is documented in docs/006-deployment.md and includes runtime prerequisites, a separate Harness profile, agent credentials, and panel settings.

07

Does DeepSeek SuperAgent support GitHub?

Yes. It is designed for one repository on github.com using a dedicated agent user account and GitHub CLI credentials. The agent needs write access. The deployment guide says GitHub Enterprise Server is not supported.

08

Is DeepSeek SuperAgent ready for production?

No. The maintainers explicitly describe it as research code that may have bugs and inconsistent engineering practices. Review and adapt the implementation before using it. Human review remains essential, and task success is not guaranteed.

09

Can beginners use DeepSeek SuperAgent?

Beginners can read the code and documentation, but operating the prototype requires familiarity with a terminal, GitHub permissions, Node.js, and local runtime configuration. The guided setup can help, but it does not remove the need to understand access permissions and review generated code.

10

Where can I find the source code?

The original source is at github.com/deepseek-ai/dsh-superagent-prototype. Start with README.md, then SETUP.md and the numbered documents in docs/. All repository buttons on this website point to that original project.