记录 Todo
在 auth-flow Workspace 中添加“处理认证边界情况”。
FREE · OPEN SOURCE · MACOS
让 Agent 并行工作。把 Git 干净收敛。
Treefold 是管理并行 Agent 开发的 macOS App。为不同任务组织独立的 Git worktree，集中运行 Agent 和 Shell，跟进任务、检查改动，并完成交付与归档。
首个公开 Alpha 已发布，支持 Homebrew 安装和 DMG 下载。独立的开发目录任务与 Session 集中管理从开工到交付收尾
完善登录功能
Todo02
○处理认证边界情况从 Todo 创建 Fork ↗
Forkvalidation
fork/validation独立分支 · 独立 worktree
○ 补充 API 集成测试→ api-tests
Fork02 · 进行中
Codex进行中
Fork / validation处理认证边界情况
src/auth/session.ts +24 −6
Claude Code进行中
Fork / api-tests补充 API 集成测试
tests/auth/api.test.ts +48
同一 Fork 中的 Session 共享 checkout
检查改动validation
src/auth/session.ts− return session.user+ validateSession(session)+ return session.user✓ 测试通过 · 等待检查
Forkvalidation→Workspaceauth-flow
合回父 Workspace ↗
完成后归档，保留 worktree 与工作记录
从 Todo 展开 Fork，为子任务创建独立的分支与 worktree。
两个 Fork 各自运行 Agent，代码改动互相隔离。
检查改动与测试结果，将 Fork 成果合回父 Workspace。
MULTIPLE AI AGENTS
使用你熟悉的 Agent。
在 Workspace 或 Fork 中运行 Codex、Claude Code、Pi、OpenCode，也可以打开 Shell 执行命令。请先安装并配置所选 Agent 的 CLI。
现已支持
- Codex
- Claude Code
- Pi
- OpenCode
01 / THE OPERATING MODEL
每项工作，都有自己的位置。
例如开发一项登录功能：把前后端仓库放进同一个 Project，为整项 feature 创建 Workspace，再用 Fork 并行处理验证与测试。
隔离发生在 Workspace / Fork 层级。同一 Workspace 或 Fork 中的多个 Session 可以共享 checkout。
从一项 Todo，到一份交付。
以登录功能为例，把任务、执行过程和代码结果连起来。
拆出 Fork
从 Todo 创建 validation Fork，启动 Agent 处理子任务。
检查结果
查看 diff、运行测试，确认改动与任务要求一致。
合回 Workspace
将 Fork 的成果交付到父 Workspace，继续集成整项 feature。
02 / KEEP WORK MOVING
切换 Session，继续工作。
代码、任务和交付目标归属于 Workspace / Fork。你可以在同一项工作中打开多个 Session，使用熟悉的 Agent 或 Shell。
工作持续保留
Session 结束后，Workspace 中的代码与 Todo 仍然保留，方便下一次继续处理。
恢复 Codex 对话
恢复已保存的 Codex 对话，继续上次的工作。
让 Agent 读取当前上下文
通过 treefold CLI 查看当前 Workspace、仓库与 Todo；支持添加、编辑、删除 Todo 和标记阻塞。Codex 启动时还会自动注入工作上下文。
当前工作与任务
- Project
- atlas
- Workspace
- auth-flow
- Fork
- validation
$ treefold current --json
$ treefold todo list --json在受管理的 Session 中使用 treefold CLI；配套 Skill 帮助 Agent 理解工作归属与操作边界。
api · TTY
RUNNING01$ amux run --name api -- cargo run
02Compiling service...
03Listening on 127.0.0.1:3001
04GET /api/health 200
05Agent Session 已结束 · 进程继续运行03 / AMUX / MANAGED PROCESSES
进程托管，跨 Session 接续。
amux 托管开发服务与长时间运行的进程。你和 Agent 可以同时查看同一份日志；切换或结束 Session 后，仍能继续查看输出、接手排查。
- ✓进程独立于 Agent Session 持续运行
- ✓你与 Agent 同时查看实时日志
- ✓跨 Session 查看日志、交互、重启或停止进程
04 / REVIEW AND DELIVER
看清改动，再决定如何交付。
在当前工作中查看 diff 和 Git History、同步分支、处理冲突。为整个 Workspace 或 Fork 选择交付方式，再逐仓库检查与执行。
检查代码与历史
查看文件改动、暂存状态和提交差异，按需提交或整理历史。
同步分支与处理冲突
通过 rebase 或 merge 更新代码；遇到冲突时，可以启动辅助处理 Session，检查解决结果后继续。
中断后继续交付
交付进度会保留。操作中断或出现冲突后，重新检查 Git 状态，再继续剩余步骤。
ChangesGit History
feature/auth-flowValidate session ownershipMina · 09:42 · 4 个文件 +86 −14
8f3ab21Add delivery preflight checksLeo · 昨天 · 2 个文件 +31 −5
62bd908Refine Todo assignmentMina · 周一 · 6 个文件 +104 −28
1ca77efDELIVERY
统一选择策略，逐仓库检查与执行
01
合并到目标
Workspace 合入本地目标，Fork 合入父 Workspace。可以阶段性交付后继续开发，也可以完成后归档。
02完成时可选
Squash merge
完成并归档时，可将本次成果合为一个目标提交，保留源分支和原始历史。
03
推送 feature 分支
Workspace 可以推送分支，接入团队已有的评审与 CI；也可以推送阶段成果后继续工作。
04
保留，不交付
不合并或推送代码，直接归档。保留 checkout，需要时重新打开；资源清理由显式删除处理。
阶段性交付保留工作状态；完成交付后归档并保留分支与 worktree。远端 PR 评审和合并在你的 Git 托管平台完成。
了解两种 Squash：整理历史与交付成果
GIT HISTORY
Squash 选中的历史
选择一段连续且未发布的 commit，将它们合并为一个。Treefold 会预览改写范围、阻止不安全的操作，并在结果仍可恢复时提供 Undo。
DELIVERY
Squash merge 到目标
把 Workspace 交付到本地目标，或把 Fork 交付到父 Workspace，并在目标上生成一个 commit。源 branch 及原始 commit 保持不变。
两种操作都不会自动 push 或 force-push；Delivery 开始前会同时检查 source 与 target。
05 / FITS THE REPOSITORY YOU HAVE
把相关仓库，放进同一项工作。
单仓库
为不同 feature 创建各自的 Workspace，避免并行任务争用同一份代码。
多仓库
前后端共同完成一项 feature：在同一个 Workspace 中组织各仓库的 checkout，并跟踪交付进度。
Monorepo 与多目录
选择具体目录启动 Session，同时保持仓库级 Git 归属。
Context Directory
把规范、笔记等参考资料标记为只读上下文，供开发时查阅。
FREE AND OPEN SOURCE
让并行的工作，有序完成。
免费开源，面向 Apple Silicon Mac。Project 状态和编排数据保存在本机，使用标准 Git 分支与 worktree。Agent 的网络访问取决于所用服务和你的配置。
如果 Treefold 对你有帮助，欢迎点个 Star，支持这个开源项目。