dsh-revdiff

dsh-revdiff

 <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/github/license/BrambleXu/dsh-revdiff?style=flat-square" alt="MIT license"></a> <a href="package.json"><img src="https://img.shields.io/badge/Node.js-%5E22.19%20%7C%20%3E%3D24-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js ^22.19 or >=24"></a> <a href="package.json"><img src="https://img.shields.io/badge/TypeScript-5.9-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript 5.9"></a> <a href="package.json"><img src="https://img.shields.io/badge/tests-Vitest-6E9F18?style=flat-square&logo=vitest&logoColor=white" alt="Tests with Vitest"></a> </p> <p align="center"> <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin#development--runtime"><img src="https://img.shields.io/static/v1?label=awesome%20%C2%B7%20DSH%20plugin&amp;message=development&amp;color=5B4CF0&amp;style=flat-square" alt="awesome · DSH plugin · development"></a> </p> <p align="center">English | <a href="README.zh.md">中文</a></p> Native interactive diff review for https://github.com/deepseek-ai/deepseek-harness. The plugin reads a Git unified diff, parses it into files, hunks, and line locations, presents its own terminal review interface, and queues submitted annotations as the Agent's next durable follow-up turn.

Why this exists 💡

Reviewing a diff in a separate tool breaks the connection between the change, the review context, and the Agent that will act on the feedback. dsh-revdiff keeps review inside Harness, so annotations are created against the actual Git diff and returned to the same durable session.

Features ✨

- Review tracked working-tree, staged, unstaged, or base-revision changes with optional path filters. - Navigate between files, hunks, and diff lines from an interactive terminal. - Add, edit, and delete issue, suggestion, question, or praise annotations. - Submit structured annotations to the current Agent through agent.followup() with message provenance. - Configure Git execution, diff context, size and time limits, terminal grace period, and comment length.

Install 📦

Add this checkout to a Harness profile: ``sh dsh plugin --profile demo add ./dsh-revdiff ` The only external runtime requirement is Git in the same execution world as Harness.

Use 🚀

`text /revdiff /revdiff --staged /revdiff --unstaged /revdiff main /revdiff --base main -- src/index.ts README.md ` The default reviews all tracked working-tree changes against HEAD, including staged and unstaged changes. --staged reviews the index, --unstaged reviews only worktree changes relative to the index, and a base revision reviews the working tree against that revision. Put path filters after --. The Harness process must own an interactive terminal. The review interface supports: - ↑/↓ or k/j: move between diff lines - n/p: move between hunks - ]/https://github.com/badlogic/pi-diff-review and https://github.com/umputun/revdiff, but this is an independent implementation built specifically around Harness commands, managed subprocesses, Agent lifecycle, and message provenance. It does not install, execute, wrap, or parse output from revdiff`.