Superagent
把编码代理、真实浏览器、项目文件和 iOS 模拟器放进同一个持久化 Mac 工作台。
- Star 数
- ★ 26
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Codex 开发 Web 应用的 Mac 用户，希望在同一窗口中查看代理对代码的修改并观察本地页面刷新。
- 主要局限
- 桌面端明确要求 Apple Silicon Mac，没有提供 Intel Mac、Windows 或 Linux 版本。
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Superagent 是一款面向 Apple Silicon Mac 的 Electron、TypeScript 和 React 桌面应用，为 Claude Code 或 Codex 提供持久化工作界面，并允许用户按对话切换代理。每个项目对话都可与真实浏览器、文件树及可选的 iOS Simulator 并排显示，代理能够操作页面，并在应用运行结果上继续迭代。新对话会在首次消息时创建独立项目副本和分支，用户随后可以用 Keep 合并为一次变更，或用 Throw away 删除该副本。对话、窗格、打开的文件和当前状态可以跨重启保留；定时 Routines、项目看板、PDF 批注、本地语音转写和上下文用量显示也集成在桌面端。核心工作负载在本机运行，使用用户已有的代理订阅，无需单独粘贴 API 密钥；手机远程功能则通过端到端加密的盲转发服务连接配套 iOS 应用。
用户在项目聊天中提交任务后，Superagent 启动所选编码代理，并让它读取和修改项目文件、启动本地开发服务器、执行命令以及更新独立分支中的代码。代理可驱动 Superagent 自己的浏览器窗格，执行打开页面、点击、输入和读取页面等操作；自动化不会进入用户的个人浏览器。iOS 工作流通过 sim_list_devices、sim_boot、sim_screenshot、sim_open_url 和 sim_install_and_launch 等工具调用 xcrun simctl，并可把 Simulator 画面串流到应用中；Xcode 是这部分功能的前提。每次对话可获得独立 checkout，完成后由 Keep 折叠为一次变更，或由 Throw away 删除。Routines 可按照自然语言定义的计时计划重复检查网站；文件阅读器支持源码、Markdown、图像和 PDF，并可原位批注 PDF。配对手机后，Mac 和 iPhone 通过使用设备密钥的端到端加密连接 superagent-relay，远程同步对话、页面和权限问题，而中继声明不存储也不能读取明文。
- 使用 Claude Code 或 Codex 开发 Web 应用的 Mac 用户，希望在同一窗口中查看代理对代码的修改并观察本地页面刷新。
- 需要让编码代理在已经登录的网站上执行点击、输入和读取操作，同时希望自动化与个人浏览器隔离的开发者。
- 开发 iPhone 应用并已安装 Xcode 的工程师，希望代理构建、启动和检查 iOS Simulator，再根据屏幕结果修复代码。
- 同时处理多个功能或实验的开发者，希望每段对话使用独立 checkout 和分支，避免不同任务互相碰撞。
- 离开电脑后仍要批准代理操作或回答问题的用户，可通过配套 iPhone 或 iPad 应用继续对话。
- 需要定时检查网页变化或重复执行浏览器任务的个人开发者，可用自然语言建立 Routines。
如何安装或部署这个 Agent？
预编译版本要求 Apple Silicon Mac。可从发布页下载 SuperAgent.dmg，打开镜像并安装已签名、公证的应用。使用 Claude Code 时，需先安装 Claude Code 并完成登录；资料也明确宣传可在每个聊天中选择 Codex，但未给出单独的 Codex 安装命令。若要使用模拟器，需安装 Xcode；若要从手机访问，还需通过 TestFlight 或 pungme/superagent-ios 源码安装配套应用，并在 Settings → Phone 中配对。源码运行步骤为：cd app、npm install、npm run dev。单元测试运行 npm test，端到端测试运行 npm run test:e2e。
如何使用这个 Agent？
添加一个项目并创建新聊天，在首次消息中描述要完成的代码任务；此时应用会为该对话建立独立项目副本和分支。按聊天选择 Claude Code 或 Codex，并使用对应的模型及权限模式；Ask mode 会在代理采取动作前向 Mac 或已配对手机请求许可。将浏览器指向本地开发服务器或在线页面，代理可以启动服务器并在可见窗格中点击、输入和读取结果。iOS 项目可让代理构建并启动 Simulator；页面或模拟器上的 ✂ 按钮及 ⌘⇧S 可截取区域并附加到消息。任务完成后选择 Keep，把工作折叠回项目成为一次变更；不需要时选择 Throw away 删除该对话的工作副本。需要远程访问时，在 Settings → Phone 扫码配对；需要周期任务时，用自然语言创建类似“每小时检查这个网站”的 Routine。
这个 Agent 有哪些优点和局限？
- 浏览器不是隐藏的后台实例：代理操作的是应用中用户可见、可随时接管且保留登录状态的独立浏览器窗格。
- 每个聊天使用独立 checkout 和分支，可并行探索多个任务，并通过 Keep 或 Throw away 明确决定保留结果。
- 把编码对话、文件差异、浏览器、PDF 和 iOS Simulator 集成在一个可跨重启恢复的桌面工作区中。
- 主要执行发生在本机并复用现有 Claude Code 或 Codex 订阅，不要求额外的模型 API 密钥。
- 手机链路采用每设备密钥的端到端加密，并允许用户自行运行
superagent-relay。
- 桌面端明确要求 Apple Silicon Mac，没有提供 Intel Mac、Windows 或 Linux 版本。
- iOS Simulator 功能依赖 Xcode；直播画面还使用带截图回退机制的原生辅助程序和私有框架路径，未来 macOS 或 Xcode 变化可能触发降级。
- 浏览器会使用真实登录会话执行操作，虽然限制在 Superagent 自己的窗格中，采用前仍需评估账号权限和自动化风险。
- 手机远程能力需要额外的 iOS 应用和中继连接；未配对手机时则没有这项远程访问能力。
- 资料对当前代理支持存在表述差异：产品介绍称 Claude Code 与 Codex 均可按聊天切换，但依赖章节只详细说明 Claude Code 的安装与登录要求。
- 其他 CLI 和本地模型仍属于路线图，现有集成不能视为通用代理插件层。
这个 Agent 与同类方案有什么区别？
相较于只在终端中运行 Claude Code 或 Codex，Superagent 增加了持久化桌面状态、可见且可接管的真实浏览器、每聊天独立 checkout、iOS Simulator 画面以及手机远程交互。它仍使用这些现有编码代理及其订阅，本身不提供新的模型或 AI 服务。README 还把其他 CLI 和本地模型支持列为未来计划，因此不能把当前版本视为任意代理的通用桌面容器。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|
| Superagent 当前 | 58 · 缺口较多 | ★ 26 | 1 天前 | TypeScript | Codex · Claude Code |
| Nimbalyst 可视化智能编码工作台 | 50 · 缺口较多 | ★ 1.8k | 1 天前 | TypeScript | Codex · Claude Code |
| Munder Difflin – 多智能体办公桌 | 43 · 缺口较多 | ★ 7.9k | 今天 | TypeScript | ChatGPT · Codex · Claude Code |
| Apache Maka | 82 · 表现良好 | ★ 5.6k | 今天 | TypeScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 对网络出口、电话配对、浏览器隔离、本地转录、独立项目检出和丢弃流程作了较具体的说明；维护注释还记录了依赖版本与 SHA-256 固定、签名、公证和更新完整性检查，因此最小权限、依赖安全、数据流与回滚获得部分肯定。扣分在于这些主要是声明而非所给实现代码的证明；Ask 模式是可选项，未说明哪些高风险浏览器、文件、定时任务或远程操作必定二次确认；@~/ 可触及广泛磁盘范围，登录态浏览器和例程能够产生外部副作用；端到端加密、盲中继、不存储及敏感数据生命周期均未由所给代码验证。许可证和三个仓库有来源标注，但维护者身份仍不明确。
依赖条件和降级路线描述较好，包括 Apple Silicon、Claude Code、可选 Xcode、捆绑 baguette、brew 后备以及模拟器流失败后退回截图。扣分在于材料存在明显不一致：开头声称 Claude Code 与 Codex 均可用，需求仅列 Claude Code，路线图又说当前只封装 Claude；正文称代理能操作模拟器，而维护注释称 sim_tap、sim_type、sim_swipe 尚未完成。用户可见失败提示仅有零散描述，缺少系统性的错误消息与恢复行为证据。
目标用户和场景覆盖充分，包括编码、浏览器操作、iOS 开发、手机协作、定时例程、文件阅读和多项目会话，因此受众与场景得满分。平台、网络和可选组件边界大体清晰，但 Codex 支持状态及模拟器代理控制能力互相矛盾。例程由自然语言触发、浏览器与磁盘访问范围较宽，材料没有给出调度冲突、作用域解析或误触发防护规则，因此触发精度扣分。环境适配明确限定 Apple Silicon macOS，但缺少 macOS、Node/npm、Claude/Codex CLI 的具体兼容版本。
README 结构清楚，按功能、需求、网络、仓库、源码运行、路线图和许可证组织，并配有场景图片。源码启动与测试命令足以支持基本入门，但未给出 Node/npm 版本、完整构建步骤和常见故障排查。Superagent、SuperAgent 及 DMG 名称大小写不完全一致；没有独立 FAQ。限制与未来功能有所披露，尤其维护注释坦承私有 API、帧流失败和发布陷阱，但重要限制被藏在非用户可见注释中。MIT 文本完整，故许可证满分；所给材料没有正式 changelog，仅有发布徽章和“What's new”声明。贡献入口存在，但版权仅写 contributors，无法明确维护责任和升级支持主体。
持久会话、独立检出、可观察浏览器、模拟器、手机协作和本地仪表盘构成了有实际价值的统一桌面工作流，输出也设计为可查看、保留或丢弃。扣分是多数效用来自产品描述，没有实现样本或操作结果可静态核对；Codex 与模拟器控制能力的不一致削弱了可用性预期。软件与既有订阅复用降低新增费用，但仅支持 Apple Silicon，并可能需要 Xcode、iPhone及相关外部 CLI，且宽权限自动化带来监督成本。
材料把路线图和已发布能力作了形式上的区分，维护注释也记录了具体版本、日期、失败实验、修正结论和发布事故，事实与计划分离因而较好。扣分在于绝大多数安全和功能声明只出现在 README；所给代码仅是 localStorage 测试垫片，无法追踪到浏览器控制、加密、网络限制、权限、回滚或更新实现。LICENSE 能交叉确认许可，测试垫片能证明存在测试基础设施的一小部分，但不足以广泛佐证产品主张。
- 不要在未核实实现前，把“端到端加密、盲中继不存储、无其他出站流量”当作已证明的安全保证。
- 登录态浏览器、@~/ 磁盘访问和定时例程具有较大的外部副作用面；在关键账户或数据上使用前，应确认逐项授权、停止机制、审计记录和不可逆操作保护。
- README 对 Codex 当前支持程度以及代理能否实际点击、输入和滑动模拟器存在冲突，应在采用前确认该修订的真实能力。
- 模拟器流依赖私有 Apple API，并以截图机制降级；系统或 Xcode 更新可能降低性能或破坏功能。
- 自动更新会影响现有安装，而维护注释记录过公证、哈希和 latest 标记失误；应独立检查发布签名、公证和更新元数据。
常见问题
是否需要另购模型服务或填写 API 密钥？
它会控制我的日常浏览器吗？
没有 iPhone 或 Xcode 能否使用？
手机消息会经过第三方服务器吗？
如果原生模拟器画面捕获失效会怎样？
simctl io screenshot 的截图镜像。