dsh-simple-worktree

Readme

# dsh-simple-worktree

A lightweight Git worktree plugin for DeepSeek Harness.

[简体中文](README.zh.md) · **English**

## Features

- Create a Git worktree from any Git Workspace.
- Choose the current branch or the repository's main branch.
- Register and open the new worktree as a DSH Workspace.
- Create task branches as `task/<name>`.
- No additional service or project configuration.
- Supports DSH themes, Chinese, and English.

## Usage

### Install

```sh
dsh plugin --profile web add github:alpacachen/dsh-worktree
```

Restart `dsh web` after installation.

If pnpm reports `MINIMUM_RELEASE_AGE_VIOLATION` for packages already in the profile lockfile, retry this command with `--config.minimum-release-age=0`. If pnpm blocks the Git package build, add `dsh-simple-worktree: true` under `allowBuilds` in the profile's `pnpm-workspace.yaml`, then retry.

### Create a worktree

1. Open a Git Workspace.
2. Open the Workspace menu and choose **Create worktree**.
3. Enter a task name, such as `login-fix`.
4. Choose **Current branch** or **Main branch**.
5. Click **Create and open**.

The worktree is created at:

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

The new Workspace is named `<parent>/<task>`.