Introduction¶
In the development of Agents within DeepSeek Harness, a common problem arises: tasks are scattered across Linear, GitHub Issues, Jira Cloud, Asana, GitLab, or local task lists, while the Harness Web side is better suited for hosting the Agent runtime environment.
dsh-dashboard is a Symphony-compatible plugin for DeepSeek Harness that converts tasks from these sources into runnable, trackable runtime objects for Harness Agents. It preserves native Harness’s session and permission system and provides a Dashboard entry in the sidebar.
What is it¶
dsh-dashboard is a multi-provider task orchestrator and dashboard maintained by Uddoo, with the currently installable version being 0.7.0.
It primarily performs the following actions:
- Reads the workflow defined in
WORKFLOW.md - Reads tasks from multiple task sources
- Applies scheduling constraints and concurrency limits
- Creates a persistent workspace for each task
- Runs tasks via native Harness Agents
- Performs a limited number of exponential backoff retries for failed runs
- Adds a Dashboard entry in the native Harness sidebar
Core Capabilities¶
Workflow Definition¶
The plugin reads WORKFLOW.md. This file contains YAML frontmatter and Liquid prompt.
A single WORKFLOW.md enables only one task source.
Task Sources¶
The plugin supports the following task sources:
- Linear
- GitHub Issues
- Jira Cloud
- Asana projects
- GitLab project issues
- credential-free local tasks
Scheduling and Retry¶
The plugin applies the following scheduling constraints:
- deterministic priority ordering
- required labels
- global concurrency
- per-state concurrency limits
Before each dispatch, the plugin rechecks the source state. Failed runs use bounded exponential backoff for retries.
Workspace and Sessions¶
Each task has a persistent workspace. The plugin runs configurable lifecycle hooks:
after_create
before_run
after_run
before_remove
Tasks run via native Harness Agents and continue within the same Harness session until the configured turn limit.
Project Catalog¶
The plugin maintains a durable Project Catalog in Harness storage.
It models Projects and Git Repositories separately to avoid conflating “projects” and “code repositories” into the same conceptual layer.
Local Tasks¶
The Local source provides Linear-style + controls for manipulating local tasks. Local tasks do not require external credentials.
Credential Boundary¶
External credentials are retained on trusted Hosts. Credential values do not enter Dashboard RPC payloads and do not enter browser state.
Installation and Enablement¶
Environment Requirements¶
Before installation, confirm the following conditions are met:
- Node.js
22.19+or24+ - pnpm
11.19+is required for source build - DeepSeek Harness Web profile
0.1.0-rc.6 - An existing Harness permission preset; bundled preset uses
workspace-write - The selected remote provider requires credentials; Local tasks do not require credentials
Install using CLI¶
First, add the plugin and view the Web configuration:
dsh plugin --profile web add dsh-dashboard@0.7.0
dsh web --dump-config
Then start Web:
dsh web
Open the address output by dsh web and select Dashboard in the native Harness sidebar.
Without Global CLI¶
If the global dsh CLI is not installed, you can use npx:
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add dsh-dashboard@0.7.0
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web --dump-config
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web
Remove Plugin¶
dsh plugin --profile web remove dsh-dashboard
Typical Usage¶
A basic flow is as follows:
-
Confirm the local environment meets Node.js
22.19+or24+. -
Confirm the DeepSeek Harness Web profile is
0.1.0-rc.6. -
Add
dsh-dashboard@0.7.0. -
Prepare credentials required by the selected remote provider; if using Local tasks, you can skip configuring remote credentials.
-
Prepare
WORKFLOW.md, ensuring it contains YAML frontmatter and Liquid prompt. -
Run the following command to check the configuration:
dsh web --dump-config
- Start Web:
dsh web
- Open the address output by
dsh weband select Dashboard in the native Harness sidebar.
Following the steps above, the plugin will read tasks from the enabled task sources in WORKFLOW.md and execute them via native Harness Agents.
Suitable Scenarios and Notes¶
Suitable for the following scenarios:
- Tasks come from Linear, GitHub Issues, Jira Cloud, Asana, or GitLab
- You want to run Agent tasks in DeepSeek Harness
- You need to maintain a persistent workspace for each task
- You need to configure
after_create,before_run,after_run,before_removehooks - You want external credentials to not enter browser state or Dashboard RPC payloads
Notes:
- The plugin runs with the current dsh process permissions; check source code and license before installation.
- Currently, the
LICENSEfile is listed in verified materials, but the license name is not displayed; confirm it yourself before use. - A single
WORKFLOW.mdenables only one task source. - Remote providers require corresponding credentials; Local tasks do not.
- The plugin requires an existing Harness permission preset; bundled preset uses
workspace-write. - The repository is compiled and tested against the published Harness
0.1.0-rc.6packages listed in verified materials.
Conclusion¶
The value of dsh-dashboard lies in putting external task sources, workspaces, lifecycle hooks, Agent sessions, and Dashboard entry points into the same DeepSeek Harness usage scenario. It is suitable for developers who need to integrate real task flows into the DSH Agent runtime environment.
Directory Page:
https://www.skillhub.cn/plugins/Uddoo/dsh-dashboard
GitHub:
https://github.com/Uddoo/dsh-dashboard