Preface

Plugins within DeepSeek Harness (DSH) are typically used in combination for conversations, tools, and browser interfaces. For agent developers, planning, feature decomposition, and defect tracking can easily become scattered across chat logs or external documents. dsh-project-kanban integrates a Kanban board into DSH: agents use kanban_* tools during conversations to write planning cards, the board is isolated by workspace (project), and data is saved to disk.

What Is This

dsh-project-kanban is a Kanban plugin within DeepSeek Harness, maintained by StruggleYang and licensed under MIT.

It solves the problem of “maintaining project cards conveniently within DSH sessions”: the browser session header provides a “Kanban” tab, and the agent tool interface can write planning cards, with data stored in kanban-board-<workspaceId>.json.

Core Capabilities

Below are the verified plugin capabilities listed in a typical usage order.

  • Agent Planning Cards: Agents use kanban_* tools to directly write cards during planning and feature decomposition.
  • Project-Based Isolation: The Kanban board is isolated by workspace (project).
  • Disk Persistence: Data is persisted to kanban-board-<workspaceId>.json.
  • Browser Entry: The browser session header provides a “Kanban” tab.
  • Card Labels and Colors: Supports labels and colors for features, defects, documentation, optimization, etc., with support for custom card colors in any #rrggbb format.
  • Priority: Supports high, medium, and low priorities with corresponding color bars.
  • Sorting and Copying: Supports sorting within columns and one-click card duplication.
  • Filtering and Search: Supports keyword, label, priority filtering and search.
  • Due Dates: Supports YYYY-MM-DD due dates and overdue highlighting.
  • Trash Bin: Supports deleting to the trash bin, restoring, or permanent deletion.
  • Batch Operations: Supports multi-select batch moving, labeling, or moving to the trash bin.
  • Statistics: Supports statistics by label, priority, and overdue count.
  • Drag and Drop: Supports dragging cards to insert into other card positions.
  • Template Columns: Supports default, dev, and content template column presets.
  • Undo: Supports up to 50 undo steps.
  • Cross-Project: Supports moving cards across workspaces.
  • Source Session: Supports recording the source session of a card and jumping back to it.

Installation and Enabling

Before installation, the dsh CLI must be installed, and a target profile must be selected. The default browser profile is web.

Installation from GitHub

Installation from GitHub is recommended:

dsh plugin --profile web add github:StruggleYang/dsh-project-kanban

If pnpm ≥ 10 refuses to run the prepare script when installing git dependencies for the first time, you need to write the package key output by pnpm into the pnpm-workspace.yaml of the target profile:

allowBuilds:
  dsh-project-kanban: true

Then re-execute the add command. allowBuilds grants code execution permissions during installation and should only be enabled for trusted sources. If you want to pin a commit, you can use the installation form with a commit, for example replacing <commit-sha> with the actual commit:

dsh plugin --profile web add github:StruggleYang/dsh-project-kanban#<commit-sha>

Installation from a Local Repository

You can also clone the repository first, then install from the local path:

git clone https://github.com/StruggleYang/dsh-project-kanban.git
dsh plugin --profile web add ./dsh-project-kanban

Installation via npm Package Name

If installing via the npm package name:

dsh plugin --profile web add dsh-project-kanban

Verification and Enabling

After installation, verify the configuration layer first:

dsh --profile web --dump-config

The output should end with the # == dsh-project-kanban layer.

Then restart dsh web. After restarting, the kanban_* tools will appear, and a “Kanban” tab will appear in the session header.

Uninstallation

The uninstall command:

dsh plugin --profile web remove dsh-project-kanban

This will remove the dependencies and layer, but the Kanban data files will remain on disk.

Typical Usage

After installation and restart, you can use it in combination between the conversation and the browser Kanban board.

  1. In a DSH session, describe the requirements, such as “split this requirement into planning cards” or “change the priority of this card.” The agent will write or update cards via the kanban_* tools.

  2. Open the “Kanban” tab in the browser session header and filter cards by keyword, label, or priority.

  3. Use column sorting, drag cards to insert into other card positions, or perform batch moves, batch labeling, or batch moves to the trash bin.

  4. Set YYYY-MM-DD due dates and pay attention to overdue highlighting; statistics can be viewed by label, priority, and overdue count.

  5. If an operation is mistaken, you can use the 50-step undo; cards can also be restored from the trash bin after deletion or permanently deleted.

  6. When cross-project processing is needed, cards can be moved to Kanban boards in other workspaces; if a card was created by an agent, you can also jump back to the source session.

Use Cases and Notes

This plugin is suitable for scenarios where you are already doing conversational development, planning, or feature decomposition within DSH, especially for lightweight usage that requires project isolation and does not need an extra external task system.

Before use, it is recommended to note:

  • This plugin runs as a dsh plugin and should be considered to have the permissions of the current dsh process during installation and runtime; please review the source code, dependencies, and license before installation.
  • allowBuilds grants code execution permissions during the installation phase and should only be enabled for trusted sources, with the option to pin a commit.
  • Uninstallation will not delete the Kanban data files; data will remain on disk.
  • The license is MIT © 2026 StruggleYang.

Conclusion

The value of dsh-project-kanban lies in capturing planning actions from DSH conversations into a Kanban board that is project-isolated, persistent, and undoable. For project source code and more information, see GitHub:

https://github.com/StruggleYang/dsh-project-kanban