用途
worktree-manager 用于管理当前 Git 仓库的 worktree,覆盖创建、列出、切换(在目标 worktree 中执行命令)、重命名、删除以及 worktree 备注管理。底层工具为 lazyworktree CLI。
主要能力
创建 worktree:支持从当前分支创建,自动生成名称(分支-形容词-名词模式),或指定名称;可用 --with-change 携带未提交改动;可用 --from-branch 直接检出已有分支或从指定分支新建;支持 --from-pr <编号> 从 GitHub/GitLab PR 创建,--from-issue <编号> 从 issue 创建,两者均可用 --no-workspace 仅创建本地分支而不创建 worktree;--generate 可从分支自动生成 worktree 名称;创建后可用 --exec 执行命令。所有 create 命令成功时会将创建的 worktree 路径打印到 stdout。
列出 worktree:lazyworktree list --json 输出 JSON(字段:path、name、branch、is_main、dirty、ahead、behind、unpushed、last_active);--pristine 仅输出路径(每行一个);--main 仅显示主分支 worktree;无参数时输出人类可读表格。别名 lazyworktree ls 等价于 list。
在 worktree 中运行命令:exec 支持通过 -w 指定 worktree 名称或路径运行命令,也支持从当前目录自动检测;可运行任意 shell 命令,或通过 --key 触发自定义命令键(注意 --key 与命令参数互斥)。
重命名 worktree:rename 可重命名当前 worktree(从 cwd 自动检测)或指定 worktree,使用 --silent 抑制进度消息。
Worktree 备注:note show 显示当前或指定 worktree 的备注;note edit 打开编辑器编辑备注,也可通过 --input 从文件设置(用 - 表示从 stdin 读取)。
删除 worktree:delete 可删除 worktree 及其分支(名称匹配时),--no-branch 保留分支,pos参数可选,能从 cwd 自动检测。
使用方式
典型工作流:用户要求创建 worktree 时,先确定来源(当前分支、指定分支、PR 编号或 issue 编号),运行对应的 lazyworktree create --silent 命令,捕获输出路径并报告给用户;若需立即在其中工作,后续命令使用 lazyworktree exec -w <名称>。切换 worktree 时先运行 lazyworktree list --json 查找目标,再用 exec -w 执行命令,并告知用户可用 cd <path> 切换 shell。列出时运行 lazyworktree list --json 并突出 dirty、ahead/behind 与 last_active。重命名时先 list --json 定位,再 rename --silent <旧名> <新名>。查看或编辑备注时用 note show 或 note edit,支持从字符串或文件输入。删除时先 list --json 展示并确认,再 delete --silent <名称>。
注意事项
--silent 抑制 stderr 进度消息,stdout 仍包含结果路径。worktree 名称会自动净化(特殊字符替换为连字符)。主 worktree 无法删除。exec -w 可在不改变 shell 工作目录的情况下运行命令。当用户表示“切换到”或“在”某个 worktree 中工作时,优先用 exec -w 运行命令,并告知路径以便手动 cd。
适用场景
适合需要并行处理多个分支的开发流程,例如同时开展新功能、检出新 PR 或 issue 分支、在独立目录中构建或测试,以及为 worktree 记录临时备注。
限制
资料未提供 lazyworktree 的安装方式、平台支持、权限要求、是否收费及版本信息,这些内容暂未提供。