Skip to content
Back to search

crew

SkillWorks with Claude CodeGitHub

在 iTerm2 里给当前会话分屏,新开一个跑在 tmux 里的 agent(codex / agy / claude,可指定模型和 effort),组员之间用 tmux 互发消息;还能把整组保存到项目目录并一键恢复窗口、模型、effort 和历史对话。用户运行 /crew,或要求"新开一个 agent / 分屏起个 codex / 保存 agent 组 / 恢复 agent 组 / 给 design 发消息"时使用。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/garmanwu--crew/badge.svg)](/listings/garmanwu--crew)

HTML

<a href="/listings/garmanwu--crew"><img src="/api/listings/garmanwu--crew/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/garmanwu/crew ~/.claude/skills/crew

需要 macOS、iTerm2、`tmux`、`python3`,以及要用到的 agent CLI(`codex`、`agy`、`claude`,已登录)。重启 Claude Code 后即可使用 `/crew`。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 85 lines
  1. ---
  2. name: crew
  3. description: 在 iTerm2 里给当前会话分屏,新开一个跑在 tmux 里的 agent(codex / agy / claude,可指定模型和 effort),组员之间用 tmux 互发消息;还能把整组保存到项目目录并一键恢复窗口、模型、effort 和历史对话。用户运行 /crew,或要求"新开一个 agent / 分屏起个 codex / 保存 agent 组 / 恢复 agent 组 / 给 design 发消息"时使用。
  4. argument-hint: "[spawn [名称] [agent] [模型] [effort] | send <名称> <内容> | read <名称> | status | save | restore]"
  5. ---
  6. # crew
  7. 所有操作都通过一个脚本完成,输出是 JSON(`ok: false` 时看 `error`):
  8. ```bash
  9. CREW=~/.claude/skills/crew/scripts/crew.py
  10. python3 $CREW <子命令> ...
  11. ```
  12. 在项目目录里运行(脚本会向上查找 `.crew.json`)。需要 macOS、iTerm2、tmux,以及要用到的 agent CLI。
  13. 参数:`$ARGUMENTS`。为空时按 `spawn` 处理。
  14. ## 约定
  15. - **组名** = 项目目录名(小写,非字母数字转成 `-`)。每个成员一个 tmux 会话,名为 `<组名>-<成员名>`,例如 `lego-design`。tmux 会话名是全局的,这个前缀用来避免不同项目的 `design` 撞在一起。
  16. - **main** = 第一次执行 spawn 的那个 Claude Code 会话。它通常不在 tmux 里,这时组员给它发不了消息,由 main 用 `read` 去读组员的窗格。执行过 `restore` 之后 main 也进 tmux(`<组名>-main`),才能双向通讯。
  17. - **状态文件**:`<项目>/.crew.json`,记录每个成员的 agent、模型、effort、会话 ID、分屏位置。
  18. ## spawn:新开一个 agent
  19. 1. `python3 $CREW models` 得到 6 个选项(codex、agy、claude 各前两个模型,带可用 effort)。
  20. 2. 用户在参数里已经给全(名称、agent、模型、effort)就直接到第 3 步。否则把 6 个选项列成编号清单,一次问清三件事:选哪个编号、agent 叫什么名字(如 `design`)、effort(默认 `high`)。让用户用一行回复,例如 `2 design high`。不要用 AskUserQuestion 做六选一(它最多 4 个选项)。
  21. 3. 启动:
  22. ```bash
  23. python3 $CREW spawn --name design --agent codex --model gpt-6.2-astra --effort high \
  24. --main-model <你自己的模型 ID>
  25. ```
  26. - `--main-model` 填你当前运行的模型 ID,恢复时 main 用它启动。
  27. - 名称只能用小写字母、数字、连字符。
  28. - 用户口头说的模型(如"astra 62")对应到 `models` 输出里的 `model` 字段;对不上就问,不要猜一个相近的。
  29. - 默认分屏位置:第 1 个在 main 右侧,第 2 个在第 1 个下方,第 3 个在 main 下方,之后依次在已有 agent 右侧。要指定位置用 `--from <成员名> --split v|h`(v 左右分,h 上下分)。
  30. - codex 默认以 full access 启动(`-s danger-full-access -a never`):执行命令不受沙箱限制,也不请求审批,范围是整台机器;这样它才能连上 tmux 主动给组员发消息。用户明确要求保留沙箱时加 `--sandbox`,此时 codex 不能主动发消息,只能被读取。
  31. 4. 脚本会等 agent 就绪、自动确认"信任此文件夹"对话框、给新 agent 发一条说明(组里有谁、怎么发消息),并记录会话 ID。看返回的 `status`:
  32. - `ready`:成功。告诉用户名称、模型、effort。
  33. - `trust_prompt` / `timeout` / `exited`:用 `read` 看窗格里是什么,把情况告诉用户。
  34. ## send / read:通讯
  35. ```bash
  36. python3 $CREW send --to design "请看一下 SPEC.md 第 3 节,给出修改建议"
  37. python3 $CREW read --name design --lines 80
  38. ```
  39. - `send` 会自动加上 `[from <发送者>]` 前缀,支持多行。
  40. - 发完消息对方需要时间处理;用 `read` 查看结果。还在生成时过一会儿再读,不要连续快速轮询。
  41. - 给不在 tmux 里的成员发消息会报错(常见于 main 尚未恢复过)。
  42. ## status
  43. `python3 $CREW status`:每个成员是否在 tmux 里、所在 tty、已保存的会话 ID 和当前实际的会话 ID。
  44. ## save:保存整组
  45. ```bash
  46. python3 $CREW save --main-model <你自己的模型 ID>
  47. ```
  48. - 重新读取每个窗格当前的会话 ID(成员执行过 `/clear` 或新开对话后 ID 会变),更新 `.crew.json`。
  49. - 在项目目录生成 `<组名>-crew.command`,双击即可恢复。
  50. - 把返回的 `updated`(ID 有变化的成员)和 `missing_session_id`(没有会话 ID、恢复时会开新对话的成员)告诉用户。
  51. ## restore:恢复
  52. 用户双击 `<组名>-crew.command`,或运行 `python3 $CREW restore --dir <项目目录>`。
  53. - 该组窗口已经开着:切换过去。
  54. - 否则新开一个 iTerm2 窗口,main 在 `<组名>-main` 里按会话 ID 恢复,其余成员按保存的分屏顺序依次恢复,各自带上原来的模型和 effort。
  55. - tmux 会话还活着(只是窗口关了)时直接接回去,不会重启 agent。
  56. - **main 的原窗口还开着时会拒绝恢复**:同一个对话不能被两个进程同时写。所以不要在 main 自己的会话里替用户执行 restore;告诉用户先退出当前这个窗口,再双击 `.command`。
  57. ## 已知限制
  58. - 只恢复分屏结构,不恢复窗格的精确尺寸。
  59. - 成员刚 `/clear` 还没说过话就保存,记录的是一个空对话的 ID,恢复时可能找不到对话;让它先回一句话再保存。
  60. - 目前只支持由 Claude Code 会话作为 main 建组。
  61. - 没有"移除成员"命令:关闭某个 agent 用 `tmux kill-session -t <组名>-<成员名>`,再手动把它从 `.crew.json` 的 `members` 里删掉。
README.md · README · 80 lines
  1. # crew
  2. 一个 [Claude Code](https://claude.com/claude-code) skill:在 iTerm2 里给当前会话分屏,几秒钟拉起一个新的 agent(Codex、Antigravity `agy`、Claude Code),指定模型和思考强度;agent 之间通过 tmux 互发消息;整组可以保存到项目目录,之后一键恢复窗口、模型、effort 和每个 agent 的历史对话。
  3. ![主会话在左,neon 和 astra 两个 agent 在右侧分屏,互相发消息;下方是保存与一键恢复](docs/crew.svg)
  4. ## 适合什么场景
  5. **快速多 agent。** 正在和 Claude Code 干活,想让另一个模型并行做一块(调研、写实现、做 review),输入 `/crew astra high` 就多一个窗格,不用自己开终端、进目录、起 tmux、敲启动参数。
  6. **监控中间态,随时微调。** 每个 agent 都是真实的交互式界面,就在你眼前的窗格里跑。它在想什么、改了哪些文件、卡在哪一步,都直接看得到;发现方向偏了,直接在那个窗格里打字纠正,不用等它跑完再返工。这是它和后台子 agent 最大的区别。
  7. **跨模型协作。** 不同厂商的模型放进同一个组,主会话可以分派任务、读取各自的进展,组员之间也能直接对话(比如让一个写、一个审)。
  8. **长期项目。** 讨论到一半要关机,保存一下;下次双击一个文件,整组 agent 带着各自的上下文回到原来的分屏位置。
  9. ## 安装
  10. ```bash
  11. git clone https://github.com/garmanwu/crew ~/.claude/skills/crew
  12. ```
  13. 需要 macOS、iTerm2、`tmux`、`python3`,以及要用到的 agent CLI(`codex`、`agy`、`claude`,已登录)。重启 Claude Code 后即可使用 `/crew`。
  14. ## 用法
  15. 在项目目录里的 Claude Code 会话(称为 main)中:
  16. ```
  17. /crew # 列出 6 个模型(codex、agy、claude 各前 2 个),回一行选择,如:2 design high
  18. /crew astra high # 直接指定:模型 astra,effort high
  19. /crew 保存工作组 # 保存成员、模型、effort、会话 ID、分屏位置
  20. ```
  21. 也可以直接用自然语言:
  22. ```
  23. 新开一个 codex 叫 design,用 astra,effort high
  24. 让 design 看一下 SPEC.md 第 3 节,给出修改建议
  25. 看看 design 现在做到哪了
  26. ```
  27. 恢复:先退出 main 所在的窗口,然后双击项目目录里的 `<目录名>-crew.command`。
  28. ### 每一步发生了什么
  29. | 操作 | 结果 |
  30. |---|---|
  31. | 新开 agent | 在 main 旁边分屏,进入同一目录,新建 tmux 会话 `<目录名>-<名称>`,带模型和 effort 启动,并告诉它组里有谁、怎么发消息 |
  32. | 发消息 | 文本送进对方的输入框并提交,自动带 `[from 发送者]` 前缀 |
  33. | 读进展 | 读取对方窗格当前的屏幕内容 |
  34. | 保存 | 重新读取每个窗格当前的会话 ID,写入 `.crew.json`,生成 `<目录名>-crew.command` |
  35. | 恢复 | 新开一个 iTerm2 窗口,按原来的分屏顺序恢复每个 agent 的对话;tmux 会话还活着时直接接回去,不重启 |
  36. ### 直接用脚本
  37. skill 背后只有一个脚本,agent 之间也是用它通讯:
  38. ```bash
  39. CREW=~/.claude/skills/crew/scripts/crew.py
  40. python3 $CREW models
  41. python3 $CREW spawn --name design --agent codex --model gpt-6.2-astra --effort high
  42. python3 $CREW send --to design "请看一下 SPEC.md 第 3 节"
  43. python3 $CREW read --name design --lines 80
  44. python3 $CREW status
  45. python3 $CREW save
  46. python3 $CREW restore --dir <项目目录>
  47. ```
  48. ## 需要知道的
  49. - **Codex 默认以 full access 启动**(`-s danger-full-access -a never`):执行命令不受沙箱限制,也不请求审批,范围是整台机器。原因是 Codex 的沙箱会拦住 tmux,关掉才能主动给组员发消息。想保留沙箱就在新开时说"保留沙箱"(`--sandbox`),这时它只能被读取,不能主动发消息。
  50. - **main 第一次不在 tmux 里**,组员给它发不了消息,由 main 去读组员的窗格。恢复过一次之后 main 也在 tmux 里,才是双向通讯。
  51. - **main 的原窗口还开着时拒绝恢复**,避免同一个对话被两个进程同时写入。
  52. - tmux 会话名带目录名前缀,不同项目里同名的 agent 不会互相干扰。
  53. - 只恢复分屏结构,不恢复窗格的精确尺寸。
  54. - 目前只支持由 Claude Code 会话作为 main 建组。
  55. - 没有"移除成员"命令:`tmux kill-session -t <目录名>-<名称>`,再从 `.crew.json` 里删掉对应成员。
  56. 模型列表、启动参数和会话存储位置在 2026-11 用 Claude Code 2.1、codex-cli 0.170、agy 1.5 验证过;这些 CLI 更新后可能需要调整。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.