OpenAgentd
在你自己的机器上运行的桌面编码智能体,每一次工具调用、改动和终端命令都看得见。
- Star 数
- ★ 217
- 最近更新
- 1 天前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 个人开发者在自己的笔记本上让智能体完成一个具体任务(例如给小型 Bun 服务加限流并跑通测试),在提交前逐条审查 diff。
- 不适合
- 需要在无浏览器、无桌面环境的纯终端流水线中无人值守跑 CI 的团队
- 要求内置 TLS、开箱即可安全暴露到公网的运维场景
- 只愿意使用单一指定模型厂商、不接受自带密钥的用户
- 官网
- openagentd.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v3.61.0(2026-11-18)
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
OpenAgentd 是一个本地优先的桌面编码智能体应用:你指定一个文件夹和一项任务,它负责规划、读取文件、修改代码、运行测试,并把每一步展示出来——包括每个带参数与耗时的工具调用、每处 diff,以及每一轮的花费。它由单个原生 Rust 后端支撑(约 46 MB 二进制、启动约 50 毫秒),桌面端会自行启动后端,会话、设置与遥测都留在本机。模型方面内置 18 家提供方(Anthropic、OpenAI、Gemini、OpenRouter、Bedrock、DeepSeek 等),也支持已有的 ChatGPT、Copilot、Grok 订阅以及通过 Ollama 运行的本地模型。产品提供 Plan 模式和 Code 模式:前者只读探索并产出可逐段评论、批准的计划,后者允许你在回合进行中引导、排队或停止。除桌面应用外,还可以只安装 CLI 后端 agentd 以终端方式运行或作为服务器供手机端和其他设备连接,并可通过 MCP 服务器、skills 和插件扩展能力。
你打开一个文件夹并描述任务后,智能体先读取仓库内容并规划:在 Plan 模式下它只做只读探索,产出一份带 "Done when" 完成条件的计划,你可以选中任意段落留言评论,再选择 Approve 或 Reply in chat 发送反馈;在 Code 模式下它直接执行,你可以随时引导、排队或中止当前回合。执行过程中它调用工具读取和编辑文件、运行 shell 命令与测试,所有工具调用及其参数、耗时、shell 输出、文件改动 diff、待办、token 与成本都流进同一份转录,可用 Reader mode 折叠为只看答案。它还能把聚焦的子任务交给 explorer#1 之类的子智能体,用 /btw 在不打断主会话的前提下旁路提问,并在编辑后显示语言服务器诊断。仓库层面提供 Git 变更、历史与图谱、worktree、真实终端和 Web 应用实时预览。除桌面端外,agentd CLI 支持 agentd server start 启动仅 API 的服务端(可用 --public --key --qr 配对手机,或用 --cloud 启用远程控制)以及 agentd run 与 agentd run --continue 运行任务,iOS 与 Android 应用通过扫描二维码连接同一批会话。
- 个人开发者在自己的笔记本上让智能体完成一个具体任务(例如给小型 Bun 服务加限流并跑通测试),在提交前逐条审查 diff。
- 需要在改动代码前先获得可控计划的团队:用 Plan 模式生成计划、在内联评论里讨论,批准后由智能体工作直到计划中的完成条件被证明。
- 希望把模型成本控制在自有账号下的用户:使用已有的 ChatGPT、Copilot 或 Grok 订阅,或用 Ollama 跑本地模型,而不是绑定单一厂商。
- 离开工位时想继续跟进任务的开发者:通过手机应用连接桌面端或 agentd server,查看同一批会话、回答问题、批准计划或停止运行。
- 需要在不污染主上下文的情况下追问细节的人:用 /btw 打开独立面板提问,答案不会进入智能体上下文。
- 想让智能体接入外部能力的团队:连接 MCP 服务器、添加 skills 与插件,或让智能体在一个脚本化步骤里串联多次工具调用。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://openagentd.dev/install.sh | shirm https://openagentd.dev/install.ps1 | iexbrew install --cask lthoangg/tap/openagentdcurl -fsSL https://openagentd.dev/install.sh | sh -s -- --cli
- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 Agent?
macOS 和 Linux 使用安装脚本:
curl -fsSL https://openagentd.dev/install.sh | shWindows 在 PowerShell 中执行:
irm https://openagentd.dev/install.ps1 | iexmacOS 也可用 Homebrew 安装:
brew install --cask lthoangg/tap/openagentd如果只需要后端(在终端运行或为其他设备提供 API 服务):
curl -fsSL https://openagentd.dev/install.sh | sh -s -- --cliWindows PowerShell 的 CLI 安装方式:
& ([scriptblock]::Create((irm https://openagentd.dev/install.ps1))) -Cli各平台构建产物在 releases 页面;未签名构建首次启动时系统可能要求确认。从源码构建的步骤见 CONTRIBUTING.md 的 Quick start 一节。
如何使用这个 Agent?
安装后打开 OpenAgentd,在第一屏连接模型:粘贴 API 密钥、用 ChatGPT 或 Copilot 订阅登录,或对检测到的密钥或 Ollama 安装点 Use。随后打开一个文件夹并描述要构建的内容。桌面端会自行启动后端,无需另外运行进程。
在输入框中按 Tab 切换 Plan 与 Code 模式;在 Plan 模式下审阅计划,选中段落评论后点 Approve,或用 Reply in chat 把评论作为普通消息发出。终端环境下使用 CLI:
agentd server start
agentd run "Summarize this project"
agentd run --continue "Now add tests for it"要配对手机,给 server start 加上 --public --key --qr;要启用远程控制,加 --cloud。agentd --help 会列出全部命令。服务器只提供 API,没有内置 TLS,暴露到可信网络之外前需要在其前面加 HTTPS 反向代理。
这个 Agent 有哪些优点和局限?
- 全流程可见:工具调用、参数与耗时、shell 输出、diff、token 与成本都进入同一份转录,还能用 Reader mode 只保留答案。
- 先计划后执行的控制方式:Plan 模式只读探索并生成可评论的计划,批准后智能体持续工作直到计划的 Done when 条件被证实。
- 模型选择自由:内置 18 家提供方,并支持已有 ChatGPT/Copilot/Grok 订阅和 Ollama 本地模型,插件还能补充其他提供方。
- 本地优先且轻量:单个 Rust 后端、约 46 MB 二进制、启动约 50 毫秒,会话、设置与遥测保留在本机。
- 面向真实仓库的能力:Git 变更、历史与图谱、worktree、真实终端、Web 预览和编辑后的语言服务器诊断。
- 同一批会话可延伸到手机:扫码配对后可在 iOS/Android 上回复、批准或停止,可选远程控制。
- 模型本身不免费:需要自备提供方密钥或订阅,或在本机运行 Ollama,使用成本取决于所用模型。
- CLI 服务器没有内置 TLS,公开暴露前必须自行部署 HTTPS 反向代理。
- 首次启动可能遇到未签名构建的系统确认提示,企业环境下的分发流程需要额外处理。
- 移动端体验依赖与桌面的配对或远程控制配置,并非独立运行的云端服务。
- Plan 模式中"工作直到计划完成"依赖计划里写明的 Done when 条件,计划质量直接决定自动执行的可控性。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenAgentd 当前 | 53 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 217 | 1 天前 | TypeScript | ChatGPT · OpenAI API · Claude API |
| Ogcode | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 148 | 3 天前 | Go | OpenAI API · Claude API |
| Pi Agent Desktop | 78 · 表现良好 | — | ★ 353 | 9 天前 | TypeScript | OpenAI API |
| Synara | 57 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2.3k | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
SECURITY.md 与 AGENTS.md 明确列出访问密钥常量时间比较、网络守卫、工作区校验、路径穿越防护、子进程参数列表、凭据 0600 原子写入、请求体上限等,属较完整的静态证据,故 least_privilege/user_confirmation/data_flow_transparency/sensitive_data_handling 给 2;但凭据为明文存储无 OS keychain、shell 检查仅为词法而非沙箱,扣分。dependency_security 有 cloud.yml 的 cargo audit 与锁定构建,但仅覆盖三个 Rust lockfile,web/Bun 依赖未见审计,给 2。external_effects 有 Plan 模式与提交前审查,但 AGENTS.md 允许代理自行 commit,属可逆本地操作,给 2。rollback 仅见 git 提交与更新校验,未见会话/文件级回滚机制,给 1。source_attribution 仅 README 与 LICENSE,无 NOTICE/第三方归属说明,给 1。
self_consistency 上 README、AGENTS.md、SECURITY.md 对架构与安全边界的描述互相吻合,给 2。dependency_availability 列出 Bun 1.4.0、Rust、cargo-nextest、python3、lsof/nc 等前置,但未给版本锁定细节与失败时的替代路径,给 1。failure_messages 仅在 drive.sh doctor 与部分代码注释中体现,未见系统性错误信息规范,给 1。
audience_and_scenarios 覆盖桌面、CLI、移动端与多 provider,场景清晰,给 2。capability_boundaries 通过 Plan/Code 模式、只读探索、审批流程界定能力边界,给 2。trigger_precision 的 SKILL.md 描述较宽泛(如 guidelines 触发条件为写/审/重构代码),缺乏精确触发条件,给 1。environment_fit 明确 macOS/Linux/Windows 安装方式与 Tauri 系统依赖,给 2。
information_architecture 有 README、AGENTS.md 分层指令、documents/docs/features.md 目录,结构清晰,给 2。install_notes 提供 curl/brew/PowerShell/CLI 多种安装方式,给 2。naming_stability 未见版本化命名约定或弃用策略,给 1。examples_and_faq 仅有快速导览与截图,无 FAQ,给 1。known_limitations 在 SECURITY.md 与 README 中说明无内置 TLS、shell 检查非沙箱、凭据明文等,给 2。license 为完整 Apache-2.0 文本,给 2。versioning_changelog 有 releases 与 features.md 版本引用,但包内无 CHANGELOG 文件,给 1。maintenance_responsibility 发布者未经验证,SECURITY.md 仅称 best-effort,给 1。
output_usability 通过 transcript、diff、成本展示与 Reader 模式提升可用性,给 2。marginal_value 相对通用编码代理提供本地优先、多 provider、移动端与可观测性,有差异化价值,给 2。cost_benefit 声称 46MB 二进制、50ms 启动,但无基准证据,且需自备模型密钥,成本收益证据不足,给 1。
claim_traceability README 多项性能与安全声明指向 SECURITY.md 与 contract 文档,但部分声明(46MB、50ms)无对应证据,给 1。cross_source_corroboration README、SECURITY.md、AGENTS.md、CI 工作流对安全与测试描述互相印证,给 2。fact_inference_separation 文档混合理念与事实,未明确区分推断与已验证事实,给 1。
- 凭据以明文 0600 存储于 credentials.yaml,无 OS keychain;shell 文件守卫仅为词法检查,非 OS 沙箱,代理命令仍可间接访问敏感文件。
- CLI 服务器无内置 TLS,暴露到可信网络之外前必须自行加 HTTPS 反向代理。
- 发布者身份未经验证,维护责任与更新路径仅靠 best-effort 承诺,企业采用前应自行核实。
- 依赖审计仅覆盖三个 Rust lockfile,web/Bun 依赖未见审计;46MB/50ms 等性能声明无基准证据。
- AGENTS.md 允许代理自行提交本地 commit,虽可逆但需确认团队对自动提交的接受度。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's changed - Remote control on Android. The Android app (Android 11 or later, with a screen lock) can sign in to your account or join it by scanning a code, add and approve devices, and open your computers through your account or directly on your home network, as the iPhone app does. Its keys stay in the Android Keystore, and approving, adding or removing a device asks for your fingerprint or screen lock. Done, Needs you and Failed notifications from your other computers arrive as pushes. …在 GitHub 查看 ↗ -
发布说明摘录
What's changed - A cleaner Connectors page, with logos. Settings → Connectors now lists your own connectors first, each with the service's logo, its status, a switch and Connect, followed by a compact gallery of the ones you have not added, under one search box. Added connectors no longer show twice. The composer's "+" menu shows full names, a status line and one-line errors (the full text on hover), and says "Connect" instead of "Sign in". …在 GitHub 查看 ↗ -
发布说明摘录
What's changed - Keys without exposing them. When a task needs an API key or token, the agent asks for it on a card. You paste the value once, on your computer or your phone, and choose which projects may use it. The agent, the transcript and the logs only ever see [secret NAME], and two projects can keep different values under the same name. Settings → Secrets lists what is stored. - Plan comments go to the chat. In a plan review, Reply in chat moves your comments into the message box, so your feedback shows in the conversation. The Plan panel's separate feedback box is gone. …在 GitHub 查看 ↗
常见问题
使用它需要额外付费吗?
代码和会话数据会离开我的机器吗?
智能体执行命令时我能拦住吗?
在服务器上怎么跑?
可以接入自己的工具吗?
OpenAgentd 官网是什么?
OpenAgentd 支持 Windows 吗?
irm https://openagentd.dev/install.ps1 | iex。OpenAgentd 开源吗?
OpenAgentd 安全吗?
OpenAgentd 还在维护吗?
OpenAgentd 是谁开发的?
谢谢反馈,我们会据此改进页面。