Development & Runtime

dsh-worktree-alpacach

alpacachen/dsh-worktree · ★ 2

alpacachen

A minimal worktree manager with one button and one dialog for DeepSeek Harness.

License
MIT
Added
2026-10-30
Maintenance
active
Install kind
npm
npm
@alpacachen/dsh-simple-worktree
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-10-30T09:38:33.141Z
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add '@alpacachen/dsh-simple-worktree@1.1.3'

从 npm 安装预构建包

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents
  1. Features
  2. Compatibility
  3. Usage
  4. Install
  5. Create from a new session
  6. Manage worktrees

A Git worktree plugin for DeepSeek Harness that creates task branches, registers worktrees as DSH Workspaces, and opens isolated sessions.

npm package: @alpacachen/dsh-simple-worktree

npm version DeepSeek Harness Plugin License

Simplified Chinese · English

Create a worktree from a new DSH session

Features

  • Create a Git worktree from the new-session action in any Git Workspace.
  • Choose the current branch or the repository's main branch.
  • Register and open the new worktree as a DSH Workspace with an isolated session.
  • Create task branches as task/<name>.
  • Manage and remove linked worktrees from the Worktree Management settings page.
  • No additional service or project configuration.
  • Supports DSH themes, Chinese, and English.

Compatibility

Built against the DSH 0.2.1-alpha.2 client contract, with support for 0.1.5-rc.1 || 0.1.5-rc.2 || 0.2.1-alpha.2 (web and desktop profiles).

Usage

Install

dsh plugin --profile web add @alpacachen/dsh-simple-worktree

Restart dsh web after installation.

In the desktop app, install the package from Plugins → Add plugin, enable it, and restart the app and host.

You can also install from GitHub with dsh plugin --profile web add github:alpacachen/dsh-worktree.

Create from a new session

  1. Open New Session in a Git Workspace.
  2. Choose Create worktree above the composer.
  3. Enter a task name. The repository's main branch is selected by default.
  4. Click Create and open.

Manage worktrees

Open Settings → Worktree Management to scan every Workspace for Git projects and linked worktrees, inspect their branch and dirty state, and remove worktrees that are no longer needed.

The worktree is created at:

project.worktrees/login-fix/
└── branch: task/login-fix

The new Workspace is named <parent>/<task>. Removing the worktree Workspace does not delete its Git branch.