ClaudeMap

work3

每个分支一条命令:work3 创建一个配置齐全的 git worktree——依赖装好、密钥拷好——并在其中启动 Claude Code 会话,并行 agent 互不干扰

SDK 与工具worktreeparallel agentsclibunnpmdeveloper tooling

work3 为并行 agentic 编码管理 worktree 工作流。两个 agent 共用一个 checkout 会互相覆盖文件;原生 git worktree 解决了这点,却让你每个分支、每天都得手动重装依赖、拷贝 .env、发明目录名、清理过期目录树。work3 open <branch> 创建 worktree、执行仓库 worktree.json 里声明的 initialize 任务(bun ci、cp $WORK3_ROOT/.env .env——一切由你配置),然后在其中启动 claude --remote-control <repo>/<branch>,让每个并行会话都带可分辨的名字;重开已存在的 worktree 会跳过任务。任务经 Bun Shell 执行,cp、rm、mkdir 等内建命令在 Windows、macOS 与 Linux 上行为一致,作用域里还有 WORK3_ROOT、WORK3_PATH 与 WORK3_BRANCH 可用。work3 ls 按 clean、dirty、missing 报告各 worktree;work3 rm 拒删未提交的工作、也绝不对不打算删除的 worktree 执行 destroy 任务;work3 fold 以纯 fast-forward 方式把完成的分支落到 base——无合并提交、无 rebase、无推送——遇到不是 fast-forward 的分支会拒绝,并提示进 worktree 内自行 rebase。配置是仓库根部的 worktree.json(或 .yaml/.yml),提交进仓库让全团队共享同一工作流。git 是唯一事实来源:没有隐藏状态,每条命令在主 checkout 或任意 worktree 内都能运行。需要 Bun 1.2.21 或更新、git,以及 PATH 上的 Claude Code(除非总是传 --no-claude)。以带作用域的 npm 包 @svara/work3 分发,命令名为 work3。

它做什么

  • work3 open <branch> 创建 worktree、执行仓库的 initialize 任务,并以 <repo>/<branch> 之名启动带 Remote Control 的 Claude Code;重开已有 worktree 时跳过任务
  • 配置放在可提交的 worktree.json——initialize 与 destroy 任务清单——全团队共享同一增强工作流;任务经 Bun Shell 执行,作用域里有 WORK3_ROOT、WORK3_PATH 与 WORK3_BRANCH
  • 安全拆除:rm 拒绝未提交或未跟踪的改动,绝不对不打算删除的 worktree 执行 destroy 任务;fold 只以 fast-forward 落分支,遇到有合并历史的分支会拒绝并提示在 worktree 内 rebase
  • 无隐藏状态:git 是唯一事实来源,worktree 目录按分支命名(feat/login 变成 worktrees/feat--login),每条命令在主 checkout 或任意 worktree 内都能用
  • 构造上跨平台:同一条 cp $WORK3_ROOT/.env .env 任务在 Windows、macOS 与 Linux 上都能跑;发布由 Conventional Commits 自动触发,以 @svara/work3 发布到 npm

什么时候用

适合多个 Claude Code 会话同时操作同一仓库——每个功能分支一个 agent、依赖与密钥各自就位、机器上不留半配置的目录树。单分支工作或不打算共享 worktree 约定的团队用不上它:它的价值恰恰在可提交、可共享的每仓库配置。

如何上手

需要 Bun 1.2.21 或更新、git,以及 PATH 上的 Claude Code(除非总是传 --no-claude):

bun add -g @svara/work3
work3 --help

或不安装直接运行:bunx @svara/work3 open feat/login

然后每个仓库一次:

cd my-project
work3 init               # 写出 worktree.json 并忽略 /worktrees/
work3 open feat/login    # 创建、配置并启动 claude
work3 ls                 # 查看所有 worktree 及其状态
work3 fold feat/login -rd  # fast-forward main,移除 worktree 与分支
work3 rm feat/login -d   # 或丢弃:执行 destroy 任务,移除 worktree 与分支

注意事项

work3 从不 fetch:base 设为 main 指的是你本地的 main——要远程就用 --from origin/main。主 checkout 里的工具(tsc、eslint、测试运行器、IDE 索引器)可能扫描 worktrees/ 目录;README 建议在它们的配置里排除该目录,或把 location 移到仓库之外。remove 遇到脏 worktree 会拒绝删除,除非强制;fold 只做 fast-forward 是有意为之——分叉过的分支要先在 worktree 内 rebase。会话以 Claude Code Remote Control 方式启动、便于从手机操控;只想要 worktree 的话传 --no-claude。MIT 许可。撰稿时 31 星(2026-11-20)。

代码仓库

svaraborut/work3

收录日期

地图上的相关资源

  • 开放的 Agent Skills 标准——任何 agent 都能加载的 SKILL.md 文件夹,2026-10-22 起由 Agentic AI Foundation 治理。

    • official
    • spec
    • agent-skills
    • standard
  • Harness Bridge

    SDK / 工具

    一个本地启动器:让 Claude Code 与其他七种编码 harness 直连任意 OpenAI / Anthropic / Responses 兼容端点——不改任何一行配置文件。

    • launcher
    • local-models
    • cli
    • menu-bar
  • Claude for Siri

    SDK / 工具

    用你已登录的 Claude Code 账号回答 macOS Spotlight 与 Siri 的提问——一个实验性的 macOS 27 模型委派提供者。

    • macos
    • siri
    • spotlight
    • model-delegation