deepseekplugins

DeepSeek Harness plugin

dsh-plugin-worktree

Claude Code-style git worktree support for dsh web: create, switch, and delete worktree sessions.

Tools & Capabilities
Jump to install

Source facts

Repository
limoiie/dsh-plugin-worktree
Latest update
Aug 19, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/limoiie/dsh-plugin-worktree
Plugin: dsh-plugin-worktree
Author: limoiie

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-plugin-worktree

![License: MIT](LICENSE) ![npm version](https://www.npmjs.com/package/dsh-plugin-worktree)

A dsh plugin that brings Claude Code-style git worktree support to the dsh web UI. Create, switch, and delete worktree-backed sessions without leaving the browser.

Features

  • New-session hero — the workspace chip shows the root workspace name when the current session is in a worktree, and the Worktree chip shows the current worktree name. You can list the repository's worktree workspaces, create a new git worktree, or switch to another worktree.
  • Sidebar badge — worktree workspaces are normal workspaces whose titles carry a ⑂ branch badge.
  • Delete dialog — deleting a worktree workspace asks whether to also remove the git worktree directory and its dsh/<name> branch, or keep them on disk.

Requirements

  • A working dsh installation
  • A web profile (dsh web)
  • git available on the host machine
  • Node.js 18 or newer

Install

From npm

dsh plugin --profile web add dsh-plugin-worktree

Restart dsh web. The plugin registers the worktree bundle row automatically.

From GitHub

dsh plugin --profile web add github:limoiie/dsh-plugin-worktree#main

Pin a released version by replacing #main with a tag, for example:

dsh plugin --profile web add github:limoiie/dsh-plugin-worktree#v0.1.0

Git-hosted installs may need pnpm's allowBuilds approval for the package's prepare script, as pnpm prints during installation.

Update

dsh plugin --profile web update dsh-plugin-worktree

Restart dsh web after updating.

If you installed from GitHub, re-run the same GitHub install command to move to the latest commit of that branch or tag.

Remove

dsh plugin --profile web remove dsh-plugin-worktree

Restart dsh web after removing. This uninstalls the plugin and removes its bundle layer from the web profile.

Quick start

1. Install the plugin and restart dsh web. 2. Open a new session. 3. In the workspace picker, open the Worktree chip. 4. Choose New worktree…, enter a name such as feat/okta-sso, and confirm. 5. dsh creates a git worktree at .dsh/worktrees/<name> on a dsh/<name> branch and opens a new session inside it.

To switch later, start another new session and pick an existing worktree workspace from the Worktree chip or the sidebar. To remove a worktree workspace, use the sidebar delete flow and choose whether to also remove the git worktree and its branch.

Configuration

The worktree row accepts:

fielddefaultmeaning
rootprocess.cwd()directory used for git rev-parse --show-toplevel
worktreesDir.dsh/worktreesworktree root; absolute, or relative to the repository top

Name rules: at most 64 characters, one or more /-separated segments made of letters, digits, dots, underscores, and dashes (feat/okta-sso works; . and .. segments are rejected).

Users can override these values in their profile or home cordis.patch.yml by targeting id: worktree without editing the plugin.

How it works

  • The host service exposes worktree/create, worktree/remove, worktree/removeWorktree, and worktree/branchExists RPCs.
  • Creating a worktree runs git worktree add -b dsh/<name> <repo>/.dsh/worktrees/<name> HEAD.
  • The browser client registers the worktree path as a normal DSH workspace and opens a new session inside it.
  • Deleting a worktree workspace asks whether to remove the git worktree and/or its branch before removing the workspace registration.

See [Architecture](docs/architecture.md) for implementation details.

Safety

  • Worktree names are validated to prevent path traversal and invalid git names.
  • Worktree paths are resolved under the configured worktrees directory; paths that escape it are rejected.
  • Branch deletion uses git branch -d, so git refuses to delete branches with unmerged commits; the client surfaces that as “branch kept”.
  • The configured worktrees directory is added to .git/info/exclude on a best-effort basis so main-checkout status stays clean.

Related plugins

The dsh ecosystem already has several worktree plugins. They are not direct replacements for each other: they emphasize different parts of the workflow, so the right choice depends on whether the worktree is primarily for the human in the web UI, for parallel agent tasks, or for durable agent-created workspaces.

PluginFocusPrimary interfaceWorktree modelBest for
dsh-plugin-worktree (this plugin)Human-first, web-native worktree sessionsdsh web: new-session hero chip, sidebar ⑂ badges, delete dialogRegular DSH workspaces created in .dsh/worktrees/<name> on a dsh/<name> branchStarting focused sessions in dedicated worktrees and managing them from the dsh web UI, with a clear choice to keep or remove the git worktree and branch on delete
dsh-plugin-worktreesAgent-first parallel task isolationworktree_* agent toolsTask-scoped worktrees with a serial merge queue and conflict-scene retentionDispatching parallel subagents into isolated checkouts and integrating their branches one at a time
dsh-worktreeDurable, Codex-style worktreesworktree_* agent tools and /worktree commandPermanent detached checkouts recorded in a per-repo manifestHaving the agent create, list, and reopen long-lived worktrees across sessions without touching the main checkout

This plugin intentionally keeps the scope on the web UI workflow: a worktree is just a DSH workspace, so creating one is also creating a session context, the branch badge makes worktree sessions recognizable in the sidebar, and deleting asks explicitly whether to remove the worktree directory and its dsh/<name> branch or keep them on disk. It complements agent-tool and merge-automation plugins rather than competing with them.

Documentation

  • [Getting started](docs/getting-started.md) — install, verify, and configure
  • [Architecture](docs/architecture.md) — how the plugin works
  • [Development](docs/development.md) — set up a local checkout and iterate
  • [Release](docs/release.md) — versioning, publishing, and store registration
  • [Contributing](CONTRIBUTING.md) — branch flow and contribution guidelines

Development

npm install
npm test

See [Development](docs/development.md) for the full local setup.

License

[MIT](LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category