Preface¶

In the DeepSeek Harness (DSH) workflow, developers often first let the current Agent modify code, then review what it changed, and finally feed the review comments back to the same Agent for further processing. dsh-revdiff is a native interactive diff review plugin designed for this workflow: it targets Git diff review scenarios within the Harness and submits the resulting annotations as follow-ups for the current Agent.

What It Is¶

The GitHub repository path for dsh-revdiff is BrambleXu/dsh-revdiff, positioned as a native interactive diff review plugin for DeepSeek Harness.

Verified runtime requirements are as follows:

• License: MIT
• Node.js: ^22.19.0 or >=24.0.0
• The only external runtime requirement: Git and Harness reside in the same execution environment

Core Features¶

dsh-revdiff currently supports the following capabilities:

• Review tracked working tree, staged, unstaged, or base version changes, with optional path filtering
• Navigate between files, hunks, and diff lines in an interactive terminal
• Add, edit, or delete issue, suggestion, question, and praise annotations
• Submit structured annotations to the current Agent via agent.followup() with a dsh-revdiff message source
• Configure Git execution, diff context, size and time limits, terminal grace period, and annotation length

Installation and Activation¶

Add the local checkout to the Harness profile:

dsh plugin --profile demo add ./dsh-revdiff

Here, demo corresponds to the profile name in the example. Before enabling, it is still recommended to review the repository source code and license.

Typical Usage¶

The usage examples provided in the README are as follows:

/revdiff
/revdiff --staged
/revdiff --unstaged
/revdiff main
/revdiff --base main -- src/index.ts README.md

Start with an overall review using the command without filters, then narrow the scope with --staged, --unstaged, or base version. Place path filters after --, for example, to review only specific files:

/revdiff --base main -- src/index.ts README.md

How Annotations Return to the Agent¶

In the review interface, you can add, edit, or delete annotations related to a specific line. Annotation types include:

• issue
• suggestion
• question
• praise

After submission, dsh-revdiff sends the structured annotations to the current Agent via agent.followup() with a dsh-revdiff message source, allowing review results to flow back into the same Agent’s subsequent processing pipeline rather than relying on external side channels.

Applicable Scenarios and Notes¶

This plugin suits developers who need to perform diff review within the Harness and hand annotations directly back to the current Agent.

Be aware of version boundaries: Version 0.1 only reviews text changes already represented by git diff. The following are not yet included:

• Untracked files
• Binary patches
• Side-by-side rendering
• Mouse input
• Browser-hosted review interfaces

Additionally, the plugin runs with the current dsh process permissions. Before installation, it is advisable to review the source code, license, and repository history to confirm suitability for your environment.

Links¶

• GitHub: https://github.com/BrambleXu/dsh-revdiff