熟悉的 Agent，继续用
从 Codex 或 Claude Code 发起任务，也能选择另一种工具执行。继承执行机器上的原生配置与默认权限。
接入 MCP，就能开始协作v1.1.0 本地与远端，一套协作方式
一个工作区，
一个工作区，
一支 Agent 团队。
继续使用你熟悉的 Codex 和 Claude Code。
让 Runweft 准备环境、委派任务、带回成果，
把下一步的决定留给你和主 agent。
接入你已有的工具 Codex Claude Code
主工作区your-project/你 + 主 agent
本机 Hub 调度⌘代码评审Codex
本机 · 独立 worktree
✳功能实现Claude Code
本机 · 独立 worktree
报告 · 代码 · 附件
一个 Runweft CLI 主工作区决定任务基线 成果回到你的手里
从你正在做的事情出发
把任务分开，
让工作接得上。
主 agent 负责判断与协调。
Runweft 负责把一次委派变成
有环境、有执行、有结果的协作。
改动各有自己的位置
本地可以共享目录，也可以独立 worktree。远端从主仓库的确定基线准备工作区，再启动子任务。
准备环境先于启动 Agent这一轮结束，下一轮接着来
任务结束关闭子进程，保留 session 和 worktree。继续委派时复用现场，依赖与之前的成果留在原处。
上下文与现场一起保留输入与输出附件启动前送达输入，完成后按清单取回文件
可审查的 Git 成果通过 bundle 传输，无需先 push 到托管平台
跨工作区的任务概览区分执行、代码和附件的状态
一次任务，如何完成
从发出委派，到拿回成果。
运行你的第一个任务- 01
定义要做什么
选择 Agent 的职责与执行目标，由主 agent 决定如何拆分任务。
- 02
先准备工作区
独立模式固定 Git 基线、落地输入文件，再启动原生 Agent。
- 03
执行，并保留现场
读取报告、处理审批或中断。每轮关闭进程，保留会话与目录。
- 04
取回，由你决定
收回代码和附件，审查后合入；需要继续时追加下一轮任务。
你说目标，Agent 处理接入
不用从一串命令开始。
安装、连接与诊断交给 Agent。
身份由你在浏览器保存和确认，
资源与任务在 Hub 后台查看。
把这段话交给 Codex / Claude Code
通过 npm 安装 runweft@1.1.0，从已安装包中读取并接入 Runweft Skill。整个接入过程中，程序安装、升级和卸载都使用 npm。帮我连接指定 Hub；没有 Hub 时先询问是否在本机启动。保留其他 MCP 和模型配置，身份通过浏览器确认，不向我索要 token。分别登记机器和执行工具，创建代码评审 Agent，再在当前项目完成一次只读委派。Skill 随 npm 包提供。Agent 从 $(npm root -g)/runweft/skills/runweft 读取完整目录，再安装到宿主的 Skill 目录；已有内容先备份和确认。
开始使用 / v1.1.0
给你的 Agent，
装上协作能力。
一条 npm 命令，自动选择平台。
先准备 Node.js 20+，
Runweft、HAPI 与 Skill 随包提供。
在终端运行
npm install -g runweft@1.1.0 --registry=https://registry.npmjs.org/ --include=optional &&
runweft --version新终端找不到 Runweft？确认 npm 全局安装目录的 bin 已在 PATH。查看路径说明
配置与执行，各有归属
维护机器、runtime、Agent、仓库与成员。分享执行能力，不公开你的私有定义或任务。
在自己的机器上开始
Agent 启动本机 Hub，再引导你确认独立身份。接入机器并登记 runtime 后才启动执行，不存在离线 YAML 模式。
让任务去合适的机器
各机器连接同一 Hub。Agent 定义和个人选择存在中心，远端以独立 worktree 执行，成果从中心取回。
常见问题
开始前，
你可能想知道。
需要同时安装 Codex 和 Claude Code 吗？
不需要。安装并登录你要使用的原生工具即可。宿主和执行 runtime 可以不同，例如从 Codex 委派给 Claude Code；使用哪一个由 Agent 的 runtime 绑定决定。
本地任务必须使用 Git 吗？
共享目录模式可以没有 Git。本地独立 worktree 和所有远端任务都要求主工作区受 Git 管理；准备使用已提交的明确基线，不会自动带上主目录未提交的改动。
任务完成后，代码会自动合入吗？
不会。Runweft 保留成果和 worktree，提供报告与取回入口。代码审查、merge / cherry-pick、冲突处理和 push 由主 agent 或你决定。
配置、会话和数据保存在什么地方？
Runweft 默认使用 ~/.runweft，执行 runweft paths 查看实际位置。Codex / Claude 的原生配置与会话沿其已有位置保存。安装 MCP 会先备份相关配置，其他 MCP 和原生设置保留。
可以继续已有任务吗？子 agent 还能再委派吗？
可以继续已有任务，Runweft 优先复用原生 session 与保留的 worktree。Runweft 子执行会禁用 Runweft MCP，避免递归委派；原生工具自己的内置 subagent 能力保持不变。
从你的下一个任务开始。
环境准备好，成果带回来，协作接着走。