graycode-for-dsh DSH plugin

Gray Code for DeepSeek Harness is a migration of the Gray Code VS Code extension into a DeepSeek Harness (DSH) plugin. It provides a comprehensive set of tools for design/progress/review/plan document workflows, permanent memory, workspace checkpoints, tree-based branching, prompt mode orchestration, and staged diff. The plugin is structured as three packages: bundle (graycode/dsh), plugin (graycode/dsh-plugin), and client (graycode/dsh-client), and currently targets DSH version 0.1.0-rc.6.

developer-tools skills-workflows

How to install the graycode-for-dsh DSH plugin

dsh plugin --profile graycode add @graycode/dsh

Copying does not run this command. Review the repository and version before installing the graycode-for-dsh DSH plugin.

graycode-for-dsh DSH plugin data source

graycode-for-dsh DSH plugin snapshot date: Aug 16, 2026

discovered

What the graycode-for-dsh DSH plugin can do

Workflow tools: create, update, validate, finalize, and compare design/progress/review/plan documents.
Permanent memory with automatic injection, supporting wake, note, recall, compress, zoom, forget, and config.
Workspace checkpoints with content-addressed blob storage, including create, list, preview, restore, delete, verify, and garbage collection.
Tree-based branching with session fork and sidecar, supporting reroll, edit retry, switch, rename, delete, and restore.
Prompt mode orchestration (D-11=c text injection) with mode list, set, and preview.
Staged diff for deferred file review, with stage, list, preview, accept, and reject (disabled by default).
Activity statistics: 24-hour heatmap, monthly, and consecutive session aggregation.
Media processing: crop, resize, rotate, generate image, and remove background using sharp, with optional model channel.
File deletion with 5MB guardrail and staged-diff hook.
Todo update via DSH table snapshot incremental ops.
Windows native toast and browser notification center with noop fallback.
Subagent hop depth, parent chain addressing, and concurrency guard.
Optional request construction layer (default off).
Settings section in DSH native settings page with 17-category Gray Code configuration.
Migration tools: scan and apply old Gray Code 1.5.4 data, with dry-run support.
Client UI with shell.overlay slot, locale, and 10 mountable surfaces (workflow, overview, memory, checkpoint, etc.).

Where the graycode-for-dsh DSH plugin fits

Manage design, progress, review, and plan documents in AI-assisted development workflows.
Retain permanent project context across sessions using memory tools.
Explore multiple solution paths simultaneously with tree-based branching and checkpoint restoration.
Conduct code reviews with staged diff and review document finalization.
Migrate existing Gray Code 1.5.4 data to the new DSH plugin format.

Who the graycode-for-dsh DSH plugin is for

Developers using DeepSeek Harness for AI-assisted programming who need structured workflow and memory management.
Existing Gray Code VS Code extension users migrating to the DeepSeek Harness ecosystem.

graycode-for-dsh DSH plugin limitations

Currently in technical preview and not yet stable; DSH version locked to 0.1.0-rc.6 (npm next).
The @graycode/* packages are not yet published to npm registry; installation requires local build and pack.
Staged diff is disabled by default and requires write tool adaptation to enable.
Media tools (e.g., generate_image) fail-closed if no model channel is injected.
Client UI has upstream GAP limitations in rc.6 for management view mount and browser remote channel.
Notifications only support Windows native toast; other platforms use browser notification center or noop fallback.

graycode-for-dsh DSH plugin: from the repository README

Quoted from the GrayCodeTeam/graycode-for-dsh README, the upstream source of the graycode-for-dsh DSH plugin. Copyright remains with the original authors.

把 [Gray Code](https://github.com/Komeiji-Shiki/Gray-Code)（原 VS Code 扩展）重构为 [DeepSeek Harness (DSH)](https://deepseek-harness.github.io/deepseek-harness/) 插件的迁移项目。 DSH 负责 Agent 循环、会话、工具流水线、权限与 Web 宿主；本仓库只保留 Gray Code 的差异化能力。 > 技术预览：DSH 锁定 `0.1.0-rc.6`（npm `next`）。规划见 [`docs/PLAN_V2.md`](docs/PLAN_V2.md)， > 进度见 [`docs/PROGRESS.md`](docs/PROGRESS.md)，变更见 [`CHANGELOG.md`](CHANGELOG.md)。 ## 能力 | 领域 | 工具 | 说明 | | --- | --- | --- | | Workflows | `create_design` / `update_design` / `create_progress` / `update_progress` / `record_progress_milestone` / `validate_progress_document` / `create_review` / `record_review_milestone` / `finalize_review` / `reopen_review` / `validate_review_document` / `compare_review_documents` / `create_plan` / `update_plan` | Design / Progress / Review / Plan 文档工作流 | | Memory | `memory_wake/note/recall/compress/zoom/forget/config` | 永久记忆 + 自动注入 | | Checkpoints | `checkpoint_create/list/preview/restore/delete/verify/gc` | 工作区快照（内容寻址 Blob） | | Branches | `branch_list/create/reroll/edit_retry/switch/rename/delete/restore` | 树状分支（Session fork + sidecar） | | Prompt | `prompt_mode_list/set/preview` | 提示词模式编排（D-11=c 文本注入） | | Staged diff | `staged_diff_stage/list/prev

Read the full READMERepository license: MIT

graycode-for-dsh DSH plugin questions

How do I install Gray Code for DeepSeek Harness?

Currently, the packages are not published to npm registry. You need to clone the repository, run `pnpm install`, `pnpm build`, and `pnpm pack` to produce a tarball. Then install it with `dsh plugin --profile graycode add ./graycode-dsh-0.1.0.tgz` and start DSH with `dsh --profile graycode`. Once published, you can use `dsh plugin --profile graycode add @graycode/dsh` directly.

Which DSH version is required?

Gray Code for DSH is locked to DSH version 0.1.0-rc.6 (npm next). If you upgrade DSH, you will need a separate compatibility PR to update the plugin. The plugin does not work with other DSH versions without modifications.

How do I enable the staged diff feature?

Staged diff is disabled by default. To enable it, you need to adapt your write tools to use the staged diff hooks. The plugin provides the `staged_diff_*` tools, but they only become active after proper integration. Check the documentation for details on how to adapt your tools.

Can I generate images with this plugin?

Yes, the plugin includes a `generate_image` tool, but it requires you to inject a model channel for image generation. Without a configured channel, the tool will fail-closed (i.e., it will not fall back to any local model). You must set up the appropriate provider in the settings.

How do I migrate my old Gray Code 1.5.4 data?

The plugin provides two migration tools: `migration_scan` to preview what data will be imported, and `migration_apply` to perform the actual import. You can run `migration_scan` with dry-run first to see the changes. The migration supports importing from the legacy Gray Code format used in version 1.5.4.