Superagent

把编码代理、真实浏览器、项目文件和 iOS 模拟器放进同一个持久化 Mac 工作台。

Star 数
★ 36
最近更新
4 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
桌面应用
可在哪里用
兼容但需适配Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Apple Silicon Mac已安装并登录 Claude Code,用于 Claude Code 对话用于 iOS 模拟器功能的 Xcode用于远程手机访问的 iPhone 配套应用Shell / 命令行网络访问本地文件系统MCP Server
典型场景
使用 Claude Code 或 Codex 开发 Web 应用的 Mac 用户,希望在同一窗口中查看代理对代码的修改并观察本地页面刷新。
不适合
  • 使用 Intel Mac、Windows 或 Linux 的用户,官方只提供 Apple Silicon 版
  • 不愿让浏览器自动化操作自己已登录账号的团队

这个 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,远程同步对话、页面和权限问题,而中继声明不存储也不能读取明文。

  1. 使用 Claude Code 或 Codex 开发 Web 应用的 Mac 用户,希望在同一窗口中查看代理对代码的修改并观察本地页面刷新。
  2. 需要让编码代理在已经登录的网站上执行点击、输入和读取操作,同时希望自动化与个人浏览器隔离的开发者。
  3. 开发 iPhone 应用并已安装 Xcode 的工程师,希望代理构建、启动和检查 iOS Simulator,再根据屏幕结果修复代码。
  4. 同时处理多个功能或实验的开发者,希望每段对话使用独立 checkout 和分支,避免不同任务互相碰撞。
  5. 离开电脑后仍要批准代理操作或回答问题的用户,可通过配套 iPhone 或 iPad 应用继续对话。
  6. 需要定时检查网页变化或重复执行浏览器任务的个人开发者,可用自然语言建立 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 当前 62 · 存在缺口 桌面应用免费 + 模型费 ★ 36 4 天前 TypeScript Codex · Claude Code
Pi Agent Desktop 78 · 表现良好 — ★ 333 今天 TypeScript OpenAI API
wmux 智能体工作台 75 · 表现良好 桌面应用 ★ 447 今天 TypeScript Codex · Claude Code
wsp 59 · 缺口较多 桌面应用免费 + 模型费 ★ 14 3 天前 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
62/ 100 五分制 3.1 / 5
信任安全 17/29
可靠稳定 8/14
适用触发 12/18
规范维护 12/18
有效结果 9/13
证据核验 4/8
查看各维度的扣分理由
信任安全17 / 29 · 2.9/5

材料描述了上下文隔离、关闭时默认禁用的电脑控制、应用级权限、停止键,以及远程控制的多重确认、超时和速率限制;这些支持了合理的权限控制和用户确认,故为2分。扣分是安全与加密等多项保证主要来自 README 和维护说明,给出的代码片段不足以全面核验实现;依赖安全也没有清单或审计证据。网络流量、凭据边界和本地数据清理有一定说明,但仍主要是自述。

可靠稳定8 / 14 · 2.9/5

agent.ts 说明了后端隔离、进程退出与会话丢失通知竞态的处理;发布工作流要求类型检查和测试,README 也列出测试命令,体现了一定自洽性和故障反馈。扣分是所给材料没有依赖锁文件或可用性策略,也无法静态确认实际错误路径覆盖程度。

适用触发12 / 18 · 3.3/5

README 明确目标用户、支持的代理、Mac Apple Silicon 与可选 Xcode/手机场景;说明电脑控制默认关闭、适用范围和限制,并描述了每聊天选择代理等边界。扣分是部分能力边界和适用情境仍以产品说明为主,材料没有完整的兼容矩阵或配置细节。

规范维护12 / 18 · 3.3/5

README 的功能、需求、网络、FAQ、源码运行步骤和路线图结构清楚;CLAUDE.md 内容指向仓库开发、发布与实现约定,而非面向 Agent 的运行技能;提供 MIT 正文。版本发布和变更说明有流程证据。扣分是维护责任主体仅标为 contributors,且提供的 changelog 样本有限。

有效结果9 / 13 · 3.5/5

项目将编码代理与浏览器、模拟器、工作树并行会话及手机交互整合,README 给出具体工作流和功能结果,支持较强的实际价值。免费与复用现有订阅降低了显性成本。扣分是收益与成本主要由项目自身陈述,材料没有独立使用证据,且设置和运行多个系统能力可能带来维护负担。

证据核验4 / 8 · 2.5/5

README 的需求、网络和功能主张较具体,能与 index.ts、preload、agent.ts、CLAUDE.md 及发布工作流中的部分实现和流程相互印证。扣分是很多主张在所给源文件片段中无法直接追溯,README 将可验证事实、设计意图和产品宣传混合呈现;因此对事实与推断的区分仅部分充分。

风险与缓解建议
  • 电脑控制与远程控制可触及其他应用或系统输入;材料描述了确认和限制措施,但未提供足以逐项核验全部防护的实现。
  • 网络与端到端加密说明主要是项目自述;给出的材料不足以独立核验完整数据流或依赖安全状况。
证据充分度:低 评估于 2026年11月8日 审查版本 53c30034db24
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/superagent-desktop.svg?lang=zh)](https://followagents.com/zh/agents/superagent-desktop)
<a href="https://followagents.com/zh/agents/superagent-desktop"><img src="https://followagents.com/badge/superagent-desktop.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v2.1.2 Superagent 2.1.2
    发布说明摘录
    Superagent 2.1.2 Dictation shows your words as you speak. Hold the mic (or ⌥Space) and the words appear in the message box while you talk, about a second behind you, in the chat and in the dot. When you let go, the whole recording is read once more and the final text replaces the guess. It still runs entirely on your Mac. Dictation no longer freezes the window. The speech model now runs in the background, so the app stays responsive while it works.
    在 GitHub 查看 ↗
  2. v2.1.1 Superagent 2.1.1
    发布说明摘录
    Superagent 2.1.1 Your claude.ai skills show in Settings → Skills. Claude Code already brings the skills of your claude.ai account to this Mac, and your chats could use them, but the Skills page said "No skills yet". They are listed now, marked claude.ai. They are changed on claude.ai, so there is no Remove for them here.
    在 GitHub 查看 ↗
  3. v2.1.0 Superagent 2.1.0
    发布说明摘录
    Superagent 2.1.0 Everything from the 2.1 betas, in one release. - Split view. Up to eight chats side by side, from any project. ⌘-click a chat or drag it in; resize, rearrange, or give one the whole window. A split is a row in the sidebar you can name, ⌘1–8 jumps between its windows, and ⌘⇧] and ⌘⇧[ go round them. Opening one never stops your other chats. Four on iPad. …
    在 GitHub 查看 ↗

常见问题

是否需要另购模型服务或填写 API 密钥?
不需要额外的 Superagent 模型服务或 API 密钥;应用使用用户已有的 Claude Code 或 Codex 订阅。Claude Code 工作流要求其已安装并登录。
它会控制我的日常浏览器吗?
不会。自动化只发生在 Superagent 自己的浏览器窗格中,但该窗格可保存自己的登录会话,因此仍应谨慎授予网站权限。
没有 iPhone 或 Xcode 能否使用?
可以使用核心桌面编码和浏览器功能。Xcode 只在需要 iOS Simulator 时必需,iPhone 配套应用只在需要远程对话和审批时必需。
手机消息会经过第三方服务器吗?
配对后,双方会向盲中继建立出站连接。资料称内容采用每设备密钥端到端加密,中继不保存数据且无法读取明文;也可以自行运行中继并在设置中更换地址。
如果原生模拟器画面捕获失效会怎样?
应用把原生辅助程序视为尽力而为的组件;二进制缺失、无法启动或启动后没有帧时,会退回基于 simctl io screenshot 的截图镜像。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。