Introduction¶
If you are already using DeepSeek Harness (DSH) for plugin-based workflows, you might need a task board that does not rely on external services and keeps data local. ttmouse/dsh-taskboard is a local-first issue board plugin for dsh, providing views like Kanban / list / Gantt / workflow / dashboard, and saving task data in a local SQLite database.
Below is an introduction to its positioning, core capabilities, installation method, and things to note.
What is it¶
Released by ttmouse, ttmouse/dsh-taskboard is a local-first issue board plugin for DeepSeek Harness (dsh). It integrates task board capabilities into the DSH plugin ecosystem, supporting multi-view task management, task details, auto-claim execution, and workspace-to-project mapping.
Data is stored in a local SQLite database:
~/.dsh/storages/dsh-taskboard/taskboard.sqlite
Verified sources state: no external service, no cloud dependency.
It is also an open-source derivative of chuspeeism/dashi-taskboard (Codex Taskboard, Apache-2.0). The Web UI, server, and data model come from the upstream project. Regarding the license:
- upstream Apache-2.0 portions retain the Apache License 2.0;
- new and modified portions use the MIT License.
Core Capabilities¶
Multi-view Task Board¶
Supported views:
- Kanban
- list
- Gantt
- workflow
- dashboard
Task Details¶
Task details include the following capabilities:
- relations
- attachments
- labels
- filters
- per-task AI chat
Auto-claim and Execution¶
Auto-claim behavior is: each workspace-mapped project claims its oldest todo issue and executes it via dsh-routines (headless session), then writes progress back to comments.
Verified sources explicitly state: no heartbeat files, no daemon jobs.
Workspaces and Projects¶
DSH workspaces are automatically synced to board projects. It can be understood as:
Workspaces = projects
Conversation Links¶
“Open in Conversation” opens the task in a real DSH session and records the thread ID on the task.
Installation and Enablement¶
Environment Requirements¶
Verified sources require:
node >=22.5
Installing the Plugin¶
First, execute the official installation command:
dsh plugin --profile web add @ttmouse/dsh-taskboard
Restart DSH Web after installation.
To view permissions, configuration, deactivation, and uninstallation instructions, check the repository’s:
plugin/README.md
Building from Source¶
If building from source is needed, the steps provided in the README are:
npm install
npm run build
Then assemble the plugin artifacts:
cd plugin && npm install && npm run build
Typical Usage¶
- Install the plugin:
dsh plugin --profile web add @ttmouse/dsh-taskboard
-
After installation, restart DSH Web.
-
Use multi-views in the task board: view Kanban, list, Gantt, workflow, dashboard.
-
Use task detail capabilities in specific tasks: view relations, attachments, labels, filters, or use per-task AI chat.
-
If you want to execute tasks automatically, let the
todoissues in workspace-mapped projects be claimed and executed via dsh-routines in a headless session; progress will be written back to the task as comments. -
If permissions, configuration, deactivation, or uninstallation are involved, check:
plugin/README.md
Use Cases and Notes¶
Suitable for the following situations:
- Need to map DSH workspaces to board projects;
- Want task data stored in local SQLite, not relying on external services;
- Need multi-views like Kanban / list / Gantt / workflow / dashboard;
- Want to execute
todoissues via dsh-routines in a headless session; - Need to reopen tasks to a real DSH session and record thread IDs.
Notes:
- The plugin runs with the current
dshprocess permissions. It is recommended to check the source code, license, and permission documentation before installing. - The license consists of two types: upstream Apache-2.0 portions remain Apache License 2.0, and new/modified portions are MIT.
- Data is written to the local SQLite path; backup and file permissions should be managed alongside the local database file.
- This article is based solely on verified sources and does not include unverified star counts or directory page URLs.
Conclusion¶
ttmouse/dsh-taskboard puts local task boards, workspace projects, auto-claim, conversation links, and SQLite data storage into a single DSH plugin. GitHub repository:
https://github.com/ttmouse/dsh-taskboard