dsh-project-kanban
A kanban board inside DeepSeek Harness, integrated with the conversation: the agent writes planning cards via kanban_* tools while you talk, boards are isolated per workspace (project), and data is persisted to disk.
This is an official bundle-format plugin (dsh.bundle declaration + cordis.patch.yml patch layer), installed through the official dsh plugin flow.
Features
- Agent-driven planning: 9 model tools (
kanban_get, kanban_add_card, kanban_update_card, kanban_delete_card, kanban_move_card, kanban_duplicate_card, kanban_add_column, kanban_rename_column, kanban_delete_column) — the agent writes cards directly during planning and feature breakdown
- Per-workspace isolation: each workspace (project) has its own board; agent tools resolve the current workspace automatically
- Disk persistence: every change is written to
kanban-board-<workspaceId>.json — survives page refresh and process restarts
- Browser board UI: a "看板" (Kanban) tab in the session header, no extra install
- Labels & colors: 功能 (feature, blue) / 缺陷 (bug, red) / 文档 (docs, green) / 优化 (optimization, orange)
- Priority: high / medium / low with a colored left-edge bar (red / orange / blue)
- Custom card color: any
#rrggbb background via the color picker in the edit form
- In-column ordering & duplication: ↑ / ↓ buttons (or the
toIndex parameter) reorder cards within a column; one-click duplicate copies label/priority/color
- Filtering & search: keyword, label, and priority filters at the top of the board
- Due dates: YYYY-MM-DD deadline with automatic overdue highlighting
- Trash & restore: delete is soft (to the trash); restore or purge from the trash view
- Bulk operations: multi-select cards to move / label / trash in one action
- Stats bar: totals by label, priority, and overdue count
- Drag reordering: drag a card onto another card's position to insert there
- Templates: default / dev / content column presets (adds missing columns only)
- Undo: every write operation is undoable (50-step stack)
- Cross-workspace move: move a card into another project's board
- Session references: cards created by the agent record their source session (click to jump back)
Installation (official flow)
Prerequisites
dsh CLI installed (npx @deepseek-ai/dsh or pnpm dsh from source)- Pick the target profile (
web is the default browser profile)
Option 1: from GitHub (recommended)
dsh plugin --profile web add github:StruggleYang/dsh-project-kanban
pnpm ≥ 10 refuses to run a git dependency's prepare script on the first try. Copy the package key pnpm prints into the profile's pnpm-workspace.yaml (at $DSH_HOME/profiles/web/pnpm-workspace.yaml):
allowBuilds:
dsh-project-kanban: true
Then re-run add.
⚠️ Security note: allowBuilds grants install-time code execution on your machine. Only allow sources you trust, and consider pinning a commit: dsh plugin --profile web add github:StruggleYang/dsh-project-kanban#<commit-sha>
Option 2: from a local checkout
git clone https://github.com/StruggleYang/dsh-project-kanban.git
dsh plugin --profile web add ./dsh-project-kanban
Option 3: tarball / npm (no build permission needed)
Download the tarball from the GitHub Releases page, or build it locally:
pnpm pack
dsh plugin --profile web add ./dsh-project-kanban-0.3.0.tgz
Published to npm:
dsh plugin --profile web add dsh-project-kanban
Verify and enable
dsh --profile web --dump-config # should end with a "# == dsh-project-kanban" layer
Then restart dsh web (bundle rows load at boot). The 8 kanban_* tools appear in the agent's toolset, and the "看板" tab appears in the session header.
Uninstall
dsh plugin --profile web remove dsh-project-kanban
Removes both the dependency and the layer; board data files are kept on disk.
How it works
- This package is a bundle (npm package + config layer):
package.json declares dsh.bundle.patch, and dsh appends it to the profile's dsh.profile.bundles after @deepseek-ai/dsh-base
cordis.patch.yml inserts the dsh-project-kanban row; the Loader resolves it by package name from the profile's node_modulesindex.js is a standard Cordis function plugin (export const name / export const inject / export function apply) registering tools via ctx.tools.register- The browser half (
lib/client.js) is a hand-written __ModuleLoader__ closure bundle (official client-modules format): require('react') resolves via the platform seed word, and the UI talks to the host through a same-origin fetch to the /api/kanban webServer route
- Tools resolve the current workspace via
exec.agent.session.header.cwd → ctx.workspaceRegistry.resolveByPath
- Layer order:
@deepseek-ai/dsh-base → this bundle → the profile's cordis.patch.yml → user --patch overlays; later layers override earlier rows by id
Agent tools
| Tool | Purpose |
|---|
kanban_get | Read the current board (optional includeArchived for the trash) |
kanban_add_card | Add a card (title, note, optional label / priority / color / dueDate) |
kanban_update_card | Update title / note / label / priority / color / dueDate |
kanban_delete_card | Soft-delete into the trash |
kanban_restore_card | Restore a card from the trash |
kanban_purge_card | Permanently delete a card |
kanban_bulk_delete_cards | Bulk soft-delete multiple cards |
kanban_move_card | Move across columns, or reorder within a column via toIndex |
kanban_duplicate_card | Duplicate a card (carries all fields) |
kanban_move_card_to_workspace | Move a card to another workspace's board |
kanban_undo | Undo the last write operation |
kanban_add_column / kanban_rename_column / kanban_delete_column | Column management |
Testing
Keyless end-to-end verification (no DEEPSEEK_API_KEY needed): creates a temporary profile, installs the local package, boots the web composition, and asserts the tool schemas plus the full HTTP workflow.
bash scripts/verify.sh
Repository layout
dsh-project-kanban/
├── package.json # bundle manifest (dsh.bundle) + client declaration (dsh.client)
├── cordis.patch.yml # patch layer: inserts the kanban plugin row
├── index.js # host plugin: 9 tools + /api/kanban data layer
├── lib/client.js # browser bundle (board UI, official client-modules format)
├── src/host.js # dynamic-plugin host half (historical reference)
├── src/client.js # dynamic-plugin browser half (historical reference)
├── README.md # this file
├── README.zh.md # 中文说明
├── TWEET.md # social post drafts (中文 / English)
└── LICENSE
License
MIT © 2026 StruggleYang
