用途:为当前 Git 仓库管理 worktree,通过 lazyworktree CLI 完成创建、列出、在指定 worktree 中执行命令以及删除等操作,适合需要并行处理多个分支或功能的开发场景。
主要能力: 创建 worktree:lazyworktree create --silent 可自动生成“分支-形容词-名词”式名称,也可传入自定义名称;--with-change 携带未提交改动;--from-branch 指定来源分支;--from-pr 42 从 PR 创建;--from-issue 123 从 issue 创建,可配合 --from-branch 指定基础分支;--exec 可在创建后执行命令,如 lazyworktree create --silent --from-branch main my-feature --exec "npm install"。创建成功时标准输出为 worktree 路径。 列出 worktree:lazyworktree list --json 输出 JSON,字段含 path、name、branch、is_main、dirty、ahead、behind、unpushed、last_active;--pristine 仅输出路径;不带参数输出可读表格。 执行命令:lazyworktree exec -w my-feature-name "make build" 可在不切换当前目录的情况下于指定 worktree 运行命令,支持任意 shell 命令。 删除 worktree:lazyworktree delete --silent my-feature-name 会同时删除同名分支;--no-branch 则保留分支。
使用方式:创建时先确定来源(当前分支、指定分支、PR 或 issue),运行相应 create --silent 命令并捕获输出路径;随后可用 exec -w <name> 在该 worktree 内执行后续命令,或提示用户用 cd <path> 切换。
限制与注意:--silent 仅抑制 stderr 的进度信息,stdout 仍为结果路径;worktree 名称会自动清洗,特殊字符替换为连字符;主 worktree 不可删除;在 worktree 中运行命令优先使用 exec -w,需要手动切换时再告知路径。