wloops/dsh-git-worktree

Let agents complete tasks in independent Git Worktrees, then review the changes before deciding whether to save them.

dsh-git-worktree is a Git Worktree plugin for DeepSeek Harness: run agents in isolated Git worktrees with one-click review, rollback, and staged saves, plus grouped worktree sessions for clear ownership. Task changes reach your project only when you start a preview or confirm saving.

This Git Worktree workflow originated in Domi, an open-source desktop coding workbench powered by the Pi Agent Runtime. This plugin is independently adapted for DeepSeek Harness and can be installed and used on its own.

中文 · Full usage guide · Architecture

Why use it?

When an agent edits the current project directly, its changes can mix with your unfinished work. Running multiple tasks at once can also make them interfere with one another. With this plugin:

• every task is edited and tested in its own Git Worktree (an independent working directory);
• multiple isolated tasks can develop in parallel in separate working directories; only one task per project can enter the review write-back flow at a time;
• when the agent finishes, you can temporarily show the changes in the current project and inspect them;
• changes are saved only after confirmation, and conflicts never overwrite your work automatically.

Highlights

• Independent working directory: every task is edited and tested in its own Git Worktree, so tasks never step on each other.
• Run multiple Worktrees: develop several tasks in parallel; to avoid mixing changes, review one task at a time per project.
• Preview before committing: inspect the real result in the current project without immediately creating a Git commit.
• Send it back safely: undo the current preview and ask the agent for more changes without disturbing unrelated local work.
• Save only this task: confirmation commits only the current task instead of pulling unrelated changes into it.
• Preserve progress on long tasks: save the current stage and keep developing; the stages still become one final delivery.
• Protect the working state: branch changes, conflicts, and interrupted operations stop safely and leave the state available for recovery.
• Tasks group automatically: current and historical Worktrees for the same project are grouped under that project in the sidebar; uncertain tasks stay where they are.
• Inspect review details in one place: open a read-only view from the review bar for changed files, validation records, and version details without searching tool messages.
• Works on empty repositories: for a repository with no commits, an empty initial commit that excludes your files is created after confirmation, then the isolated Worktree is built.
• Carry project Skills: the first Worktree and each next iteration receive one snapshot of .dsh/skills, .agents/skills, and .claude/skills, while auxiliary files stay separate from Git delivery.
• Continue in the same conversation: after delivery, begin another task without opening a new conversation.

The current version manages Git Worktrees within one project. It does not yet provide a global cross-project manager.

Workflow

flowchart LR
    A[Current project] -->|Create isolated task| B[Independent Git Worktree]
    B --> C[Agent edits and tests]
    C --> D[Review the result]
    D -->|Preview changes| E[Inspect them in the current project]
    E -->|Confirm and save| F[Create the task commit]
    F --> G[Continue in the same conversation]

    D -.->|Save current progress| H[Keep developing]
    E -.->|Undo this preview| I[Return for changes]
    D -.->|Skip preview| F

Which action should I choose?

Goal	Action
Inspect the result in the current project	Preview changes
The preview looks correct	Confirm and save
Preserve progress during a long task	Save checkpoint and continue
Ask the agent for more edits	Continue editing or Undo this preview
Save without inspecting it first	Skip preview and save

See the full usage guide for detailed actions, recovery scenarios, and commands.

Quick start

Requirements

• Node.js ^22.19.0 || >=24.0.0
• DeepSeek Harness Web Client
• A Git Workspace
• A plugin version matching your Harness version, as listed below

Choose a version

DeepSeek Harness	Plugin version
0.2.2-rc.1	0.12.3 (current version)
0.2.1-rc.2 (build baseline), 0.2.1-rc.5	0.12.3
0.2.0-rc.2	0.10.0
0.1.x	See the historical 0.9.x compatibility records; not every 0.1.x version has been verified

Match the plugin version to your Harness version rather than installing the latest plugin on an older Harness. Verification scope, known limitations, and installation policy per version are covered in the compatibility notes.

Install

Install the current version through the dsh Web Profile:

dsh plugin --profile web add dsh-git-worktree@0.12.3

For other Harness versions, choose the matching plugin version from the table above first.

Open a Git Workspace and enable Worktree when creating a Session. An existing Local Session can also let the agent call worktree_create to create a separate isolated Session.

For the first run, complete one full create → Preview changes → Confirm and save → clean up the Worktree cycle.

Upgrades and troubleshooting

• Back up your data and check version compatibility before upgrading Harness. See the compatibility notes for legacy data migration requirements.
• If the UI shows Failed to load plugins, first check that the plugin and Harness versions match, then follow the troubleshooting guide.
• Harness's supply-chain guard (minimumReleaseAge) may skip a freshly published release and fall back to an older one. Specify the matching exact version explicitly or retry after the guard window passes.

For Git-source installation, pnpm build approval and other troubleshooting steps, see Installation and troubleshooting.

Screenshots

Project grouping and task status

Prepare the review

Conflict and recovery

When a conflict or branch change is detected, the plugin inspects read-only and preserves the state for you to decide:

See the full usage guide for the complete flow.

Safety boundary

Before writing task changes back to the current project, the plugin checks again that the task version, project location, and file state still match the review. If you switched branches, changes conflict, or a previous operation was interrupted, it stops and preserves the working state instead of guessing and overwriting files.

Worktree separation is designed to prevent tasks from accidentally changing one another's files. It is not a system sandbox for running untrusted code.

For the detailed state checks and recovery rules, see:

• Worktree Console architecture
• Session Target porting notes

Current limitations

• A task is grouped under its original project only when that relationship is clear. Uncertain tasks remain in their original location so they are never hidden.
• Isolated tasks can be renamed and archived, but a new task cannot yet be forked directly from the task conversation.
• Child agents share the parent task's working directory; a separate Worktree is not created for every child agent.
• Saved stage records cannot yet be edited, deleted, reordered, or rolled back to an arbitrary stage.
• The broader cross-project management, direct repair of the current project, dependency reuse, and collaboration handoff features in Domi are outside this plugin's current scope.

Local development

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run check:publish

Run the local end-to-end environment:

pnpm run dev:dsh

See the full usage guide for more development commands and the release checklist before publishing.

Documentation

• Full usage guide
• Worktree Console architecture
• Session Target porting notes
• UI development notes
• Release checklist
• Changelog

License

MIT

Language

The plugin follows DSH’s language selection without a separate switch. Explicitly select English in DSH to use English in the UI, tools, and /worktree messages. If automatic browser detection has not produced a saved DSH preference, tools and commands fall back to Chinese. See language transport and translation contributions.