AI 分析

核心用途是管理持久化的 Git 工作区。适合需要在多个代码分支或独立工作区中并行执行任务的开发人员与 Agent 协作场景。

包名

dsh-worktree

版本

0.1.0

许可证

MIT

Usage

Agent tools

worktree_create {name, baseCommit?} — create a permanent detached worktree of the repository containing the current session (default base: current HEAD). Returns the worktree path, repo root, and base commit.
worktree_list — list registered worktrees with live git state (exists, HEAD, branch).
worktree_remove {name, force?} — remove a registered worktree (--force also discards uncommitted changes). Refuses to remove the worktree the current session is working inside.

Chat command

/worktree                          # list (same as /worktree list)
/worktree list
/worktree create  []
/worktree open               # print path/state + register as workspace
/worktree remove             # (close/delete accepted as aliases)

Session context

When a session's workspace is inside a registered permanent worktree, the agent is told once: which worktree, of which repo, at which base commit, plus the management commands.