dsh-git

English | 中文

A session-scoped Review panel for dsh-dock that shows the current repository's working-tree diff against HEAD, with inline review comments that travel with your next message.

What it does

dsh-git adds a session-scoped Review panel to dsh-dock. It shows the current repository's tracked working-tree diff against HEAD, lists untracked paths, and supports unified and split rendering with Pierre. Hover a diff gutter and use the comment button to start a review; drag across line numbers or Shift-click another line to select a contiguous range, write the comment inline, then choose Add comment.

Added comments become compact pills above the normal chat composer. Click a pill to inspect its file, range, selected lines, and comment, or remove it with its × button. You can collect several comments and add ordinary prose in the composer; nothing reaches the agent until you use the normal Send button.

The panel and Pierre renderer follow the active Harness light or dark theme, including live theme changes.

An icon-only toggle beside the session-header Open control shows or hides Review. The plugin does not add a fallback button to the chat composer or an entry to the generic Panels launcher.

Version 1 is deliberately read-only. It does not stage, apply, commit, reset, switch branches, manage worktrees, or integrate with a forge.

Install

Requires dsh-dock, the dsh CLI (Node.js 22.19+ or 24), and pnpm 10+. The panel starts closed and loads the active session's repository only when opened.

From npm

dsh plugin --profile web add @mattismegevand/dsh-git

From GitHub

dsh plugin --profile web add github:mattismegevand/dsh-git

Git installs fetch sources, so pnpm runs the package's prepare build on first add. pnpm ≥10 refuses that until you allow it: copy the exact package key pnpm printed into the profile's pnpm-workspace.yaml allowBuilds entry, then re-run the same add.

Develop locally

git clone https://github.com/mattismegevand/dsh-git.git
cd dsh-git
corepack pnpm install
corepack pnpm check:all
dsh plugin --profile web add .

Configuration

• maxRequestBytes bounds request bodies (default: 32 KiB).
• maxPatchBytes bounds complete Git outputs (default: 8 MiB).
• maxFileBytes omits individual file patches above the limit (default: 2 MiB).
• gitTimeoutMs bounds each Git subprocess (default: 10 seconds).

Safety and lifecycle

Git is resolved through the Harness subprocess service and invoked with exact argument arrays. Prompts, pagers, external diffs, and text conversion are disabled. Reads are timed out, cancellable, output-bounded, and confined with the session sandbox unless the session already runs in danger-full-access mode.

Binary files, submodules, oversized patches, and unsupported entries are listed but not rendered. Untracked file contents are never read. Each pending comment is revalidated against the displayed diff revision while the normal composer submission serializes it. A changed diff blocks submission and leaves the comment available to inspect or remove. Host routes, dock registrations, input-reference registrations, locale dictionaries, and browser styles are reversible Cordis effects.

Related plugins

• dsh-dock — the docking system that hosts this panel.
• dsh-terminal — VS Code-style Ghostty terminal panel.
• dsh-open — Codex-style workspace Open menu in the session header.

Model experience

The plugin adds no tools, prompt sections, automatic model calls, or independent follow-ups. Pending comments are browser-owned composer references. Normal submission expands each reference into the path, side, bounded line range, selected diff text, and comment, alongside any additional text you wrote. This has no independent KV-cache effect.

Known limitations

The first release reviews only HEAD against the working tree. It intentionally does not display untracked file contents, forge metadata, staged and unstaged changes separately, or mutation controls.

License

MIT