Back to directory

dsh-agent-teams

Curated pickMaintenance: Active

nanmicoder/dsh-agent-teams

AgentTeams plugin for DeepSeek Harness

View on GitHub
$ dsh plugin --profile web add @nanmicoder/dsh-agent-teams

1,458

stars

124

forks

JavaScript

Language

MIT

License

2026-08-12

Created

2026-09-05

Last push

MIT-licensed native DeepSeek Harness plugin that turns one session into a captain-led multi-agent team — install with `dsh plugin add`, no extra workflow engine needed.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

MIT

01What can it help you accomplish?

  • Turn one natural-language goal into a coordinated multi-agent team that runs and consolidates the result inside DeepSeek Harness

    A captain-led team of durable sub-agents with dependency-aware tasks, direct messaging, and one consolidated final report

    Developers and tech leads running DeepSeek Harness (dsh) who want ai agent automation with automatic task splitting and delegation

  • Watch and audit multi-agent runs in real time without a separate workflow engine

    A live Web activity panel with segmented progress, a collapsible roster, and an interactive task DAG; completed archives retain full member and task history

    Engineering teams that need visibility into parallel agent work inside the DSH Web UI

02How to install into DeepSeek Harness

Prerequisites

  • An existing DeepSeek Harness installation (the README requires it before install)
  • git and pnpm only when building from source

Installation steps

  1. 01

    Install from npm: `dsh plugin --profile web add @nanmicoder/dsh-agent-teams`

    $ dsh plugin --profile web add @nanmicoder/dsh-agent-teams

  2. 02

    Or build from source: `git clone https://github.com/NanmiCoder/dsh-agent-teams.git && cd dsh-agent-teams && pnpm install && pnpm build`, then `dsh plugin --profile web add .`

    $ git clone https://github.com/NanmiCoder/dsh-agent-teams.git && cd dsh-agent-teams && pnpm install && pnpm build

  3. 03

    Validate the composed profile and restart DSH: `dsh --profile web --dump-config` then `dsh web`

    $ dsh --profile web --dump-config

  4. 04

    Ask for a team directly in the session, e.g. ask AgentTeams to review commits and return one consolidated report

Verify the integration

  • Run `dsh --profile web --dump-config` to validate the composed profile, restart DSH with `dsh web`, and refresh the Web UI
  • Ask in the session: "Use AgentTeams to review the commits after v0.5.3 from performance, security, and product perspectives. Return one consolidated report."

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DeepSeek Harness plugin installed with `dsh plugin --profile web add @nanmicoder/dsh-agent-teams`; the current session becomes the team captain inside DSH

  • Captain-led delegation

    a natural-language goal in the current DSH session (or `/agent-teams <goal>`)a team where the current session creates the team, assigns roles, and consolidates the final result

    spawns DSH sub-agents that consume model calls on the snapshotted provider/model route
  • Dependency-aware tasks & automatic scheduler

    a goal split into tasks with owners and explicit dependenciestasks claimed atomically per idle member; idle members reused for ready work; revoked stale attempts and cold recovery of stranded open attempts

    team state is written to disk under `<workspace>/.agent-teams/`
  • Live activity panel (Web UI)

    persisted team state plus live sub-agent activitysegmented progress, collapsible roster, interactive task DAG; completed archives keep full member and task history

  • Deterministic /agent-teams activation

    `/agent-teams <goal>` from the Web GUI slash menu or the headless CLI gesture boundarythe handler queues one deterministic activation message and the captain protocol starts immediately; invocation logged as `command/run` / `command/done`

    invocations are durably logged

04Who is it for? When not to use it?

Good for

  • Developers and tech leads running DeepSeek Harness (dsh) who want ai agent automation with automatic task splitting and delegation
  • Engineering teams that need visibility into parallel agent work inside the DSH Web UI

Not for

  • State is file-backed and serialized within one DSH process; concurrent processes editing the same team are not coordinated.

05Compatibility, maintenance and safety notes

  • State is file-backed and serialized within one DSH process; concurrent processes editing the same team are not coordinated.
  • One captain leads one active team at a time.
  • The activity panel reports persisted state as-is; models may occasionally finish work without performing the expected task-state update.
2026-08-122026-08-17v0.1.8

MIT · actively maintained (latest release v0.1.8, 2026-08-19)

06Frequently asked questions

How does dsh-agent-teams integrate with DeepSeek Harness?

It is a native DSH plugin: install it with `dsh plugin --profile web add @nanmicoder/dsh-agent-teams`, validate the composed profile with `dsh --profile web --dump-config`, restart DSH with `dsh web`, and refresh the Web UI. It is not an MCP server — the current session itself becomes the team captain.

What prerequisites do I need?

Only an existing DeepSeek Harness installation. Defaults work without extra setup; a trusted profile can optionally override member behavior (stateDir, memberProvider, memberModel, maxMembers, etc.).

How do I start a team?

Use the `/agent-teams` slash command in the Web GUI, start a message with `/agent-teams` in surfaces like the headless CLI, or just ask in natural language — e.g. "Use AgentTeams to review the commits after v0.5.3 ... Return one consolidated report."

Where is team state stored?

Under `<workspace>/.agent-teams/` on disk. The Web panel reads that persisted state and combines it with live sub-agent activity; state is serialized within one DSH process.

What are the main limits?

One captain leads one active team at a time, concurrent DSH processes editing the same team are not coordinated, and the activity panel reports persisted state as-is — models may occasionally finish work without the expected task-state update.

08Data and sources

  • Author-claimedgithub.com801954dd7be6…

    `dsh-agent-teams` turns the current DeepSeek Harness session into a captain that can assemble durable sub-agents, split…

  • Author-claimedgithub.com801954dd7be6…

    dsh plugin --profile web add @nanmicoder/dsh-agent-teams

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.