Refresh 是一个面向真实软件开发场景的开源 AI 编码代理客户端。它把 Claude Code、Codex 等代理能力，与本地仓库、隔离的 git worktree、后台沙箱执行和可视化桌面 UI 放进同一个工作空间。
你不再需要在终端、浏览器、diff 工具和聊天窗口之间来回跳转。Refresh 把完整闭环放到了一处：先规划，再执行，接着审查改动，最后再决定是否交付。
为什么要做 Refresh
编码代理只有进入一个安全、可审查、可回退的工作流，才真正有生产力。
Refresh 的核心思路很直接：
- 让代码尽量留在开发者本地
- 让代理的每一步动作都可见
- 让高风险改动天然远离主分支
- 同时支持本地执行与云端后台运行
Refresh 面向的是那些既想要代理速度，又不愿放弃可控性、可审查性和环境主权的开发者与团队。
Refresh 和普通 AI 编码工具有什么不同
1. 一个产品里同时支持多个代理
Refresh 不绑定单一模型供应商。你可以在同一个应用里运行 Claude Code、Codex，以及其他模型或 provider 组合，并根据任务类型自由切换。
这很重要，因为规划、编辑、浏览、长任务执行，往往并不适合由同一个模型全部承担。
2. 本地优先
你的仓库保留在自己的机器上。Refresh 以本地开发流程为中心设计，你可以把代理直接指向真实项目目录，随时查看它在做什么，并把敏感代码留在你自己的环境里。
3. Git Worktree 隔离
每个会话都可以运行在独立 worktree 中，而不是直接碰主分支。这会直接消灭一类常见脏问题：误改当前分支、实验互相污染、改动难以审查。
好设计不是增加分支判断，而是让特殊情况自然消失。worktree 隔离就是这种有品味的设计。
4. 合并前先做可视化审查
Refresh 不只是一个聊天界面。它还提供 diff 预览、工具执行日志、git 活动、文件查看和回滚导向的交互，让你在接受结果前先看清楚到底发生了什么。
代理越快，审查链路就越不能含糊。
5. 后台代理与浏览器预览
并不是所有任务都适合绑在当前笔记本会话上。Refresh 支持在云端沙箱中后台运行任务，也支持开发分支的实时浏览器预览，让工作在你离开电脑后仍可继续推进。
Refresh 的核心工作流
Refresh 围绕几个非常实际的循环构建：
- 任务不清晰时，先进入 Plan Mode。
- 方向明确后，在安全工作空间里运行代理。
- 实时查看命令、文件修改和工具调用。
- 在提交前检查 diff、git 变化与输出结果。
- 需要长时间执行时，再转交给后台代理或自动化。
这就是“和 AI 聊代码”与“真正的编码代理工作环境”之间的区别。
适合谁用
Refresh 很适合下面这些人：
- 面对真实仓库，而不是只处理演示 prompt 的开发者
- 想对比或组合多个编码代理的人
- 在意分支安全、改动可审查性和回退能力的团队
- 需要桌面优先，同时保留云端后台执行能力的工作流
- 希望把 MCP、自定义模型供应商、斜杠命令、memory 文件和自动化放到同一产品里的用户
一个更简单的理解方式
如果说终端提供的是原始力量，那么 Refresh 提供的是操作清晰度。
它把下面几件事组合到了一起：
- 本地开发的灵活性
- 隔离执行的安全性
- 可视化审查层的透明度
- 现代 AI 编码代理的杠杆能力
最后
Refresh 围绕一个非常朴素的判断构建：编码代理真正有价值，不在于看起来多神奇，而在于它是否可见、可控，并且真的嵌入了真实开发流程。
少一点魔术演示，多一点可交付的软件，这就是 Refresh 想做的事。
