AgenC Core

面向终端的开源 AI 编程代理,支持任意模型,并以极低成本取得终端基准高分。

Star 数
★ 75
最近更新
今天
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具自托管服务代码库 / SDK
可在哪里用
通用 · 跨平台
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Node.js 26.12.1(独立安装包内置;源码与 npm 安装需 >=26.5 <27)npm 11.17.0PATH 中的 ripgrep(rg)Linux 源码构建需要 C11 编译器(cc)模型服务商 API 密钥或本地模型运行时(如 XAI_API_KEY、Ollama、LM Studio)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
在终端里让代理定位并修复回归、跑测试直到全部通过的开发者。
不适合
  • 依赖图形化 IDE 而非终端的开发者
  • 要求免配置直接使用的最终用户

这个 Agent 能做什么,适合哪些场景?

AgenC Core 是 agenc CLI 的实现仓库,包含一个本地守护进程(daemon)以及多个客户端:交互式 React TUI、无头模式(agenc -p / --no-tui)、后台代理、频道网关和手机远程桥接。守护进程独占会话生命周期、权限、模型服务商调用和命令执行,每个 AGENC_HOME 只有一套控制平面。产品内置 Bash、文件读写编辑、事务式 apply_patch、web 抓取搜索、LSP、MCP 以及通过 CDP 驱动的浏览器工具,并提供权限模式、可选操作系统沙箱与安全审计。它支持 17 个内置服务商(默认 grok),也可经 Ollama、LM Studio 使用本地模型;通过 Telegram、Discord、Slack、WebChat 接入频道,并可配对 iOS/Android 远程操控。代码以 MIT 许可发布,运行时与启动器版本 0.19.19,嵌入式 SDK 为 @tetsuo-ai/agenc-sdk 0.3.0。

用户在终端运行 agenc 并给出提示词后,启动器会自动拉起守护进程 app-server,由它负责会话、权限与服务商调用。代理调用内置工具完成任务:Bash 执行命令、文件读取/写入/编辑、事务式 apply_patch、web fetch/search、LSP、MCP 以及通过 CDP 管道操作隔离 Chromium 的 Browser 工具。会话以只追加日志加 SQLite 状态持久化,可通过 --continue / --resume 恢复;后台代理由 agenc agent start|list|attach|stop|logs 管理。网关 agenc gateway run 把消息从 Telegram、Discord、Slack、WebChat 或 stdio 接入,git 之外的预算由 agenc budget status 查看。无头模式支持 --output-format json 与 stream-json,便于脚本和 CI 使用;agenc mcp serve 可将自身作为 MCP 服务端暴露,@tetsuo-ai/agenc-sdk 则用于以 socket/子进程方式嵌入守护进程。

  1. 在终端里让代理定位并修复回归、跑测试直到全部通过的开发者。
  2. 在 CI 或脚本中通过 agenc -p --output-format stream-json 做自动化代码摘要与改动。
  3. 希望用本地模型(Ollama、LM Studio)而不把代码发送到云端的团队。
  4. 需要从手机远程发起或跟进后台代理任务的运维与个人开发者。
  5. 把 AgenC 作为 MCP 服务端或通过 @tetsuo-ai/agenc-sdk 嵌入自有工具链的工程团队。
  6. 在 Telegram/Discord/Slack 中通过网关与代理协作的团队。

如何安装或部署这个 Agent?

推荐用官方安装脚本,独立安装包会自带 Node.js 26.12.1 运行时:

curl -fsSL https://get.agenc.ag/install.sh | sh

也可以用 npm 全局安装(需 Node.js >=26.5 <27):

npm install -g @tetsuo-ai/agenc
agenc --help

从源码构建:

npm ci
npm run build
node runtime/bin/agenc --help
npm run start

安装前请确保 ripgrep 在 PATH 中;Linux 源码构建还需要可用的 cc 编译器。

如何使用这个 Agent?

首次运行执行引导式配置,然后设置服务商密钥(默认 xAI):

agenc onboard
export XAI_API_KEY=your_key
agenc doctor

交互式使用与无头使用:

agenc
agenc --no-tui "summarize this repository"
agenc --print --output-format stream-json "summarize this repository"

后台代理与守护进程:

agenc daemon status
agenc agent start "fix the failing parser test"
agenc agent list

可在 config.toml 中通过 agenc config set 配置服务商、权限与预算;AGENC_HOME(默认 ~/.agenc)必须位于本地单主机文件系统。

这个 Agent 有哪些优点和局限?

优点
  • 守护进程 + 多客户端的进程模型,TUI、无头、后台代理与网关共享同一控制平面。
  • 服务商广:17 个内置服务商并支持 Ollama、LM Studio 等本地模型,不锁定单一厂商。
  • 成本证据具体:README 称在 Terminal-Bench 2.1 上用 DeepSeek V4.1 Flash 取得 76.2% 且花费 34 美元。
  • 安全层次明确:权限模式、可选 OS 沙箱(bubblewrap/Landlock、Seatbelt)、agenc security audit 与事务式 apply_patch。
  • 既可作为 CLI 使用,也能通过 @tetsuo-ai/agenc-sdk 嵌入或用 agenc mcp serve 暴露为 MCP 服务端。
  • MIT 许可且类型检查干净(0 个 @ts-nocheck),提供 SBOM 与可验证的 npm 溯源。
局限
  • 运行时依赖严格:源码与 npm 安装要求 Node.js >=26.5 <27,且必须使用 npm 11.17.0。
  • 持久化定时提示需要 Linux 目录描述符与本地 OS 账户主目录,升级时还需先停掉旧调度/网关进程。
  • AGENC_HOME 不能放在 NFS/SMB 或多主机容器卷上,对部署环境有实际约束。
  • 发布级测试门槛高:npm test 需要 Docker Engine 25.0+、特定 Linux 内核与 seccomp 能力。
  • 功能面广(网关、远程控制、Ledger 钱包、浏览器工具),学习和配置成本高于单一用途工具。
  • 默认服务商为 xAI/Grok,未配置密钥时无法进行真实模型调用。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
AgenC Core 当前 74 · 存在缺口 命令行工具免费 + 模型费 ★ 75 今天 TypeScript —
FuXi 终端 AI 编程代理 37 · 缺口较多 命令行工具免费版 + 付费版 ★ 3.2k 6 天前 Python OpenAI API · Claude API
Orca 59 · 缺口较多 命令行工具免费 + 模型费 ★ 510 今天 Rust —
agentty 44 · 缺口较多 命令行工具免费 + 模型费 ★ 617 今天 C++ OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

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

证据显示 fail-closed 沙箱设计、按 spawn 最小权限、密钥清洗、SSRF 代理、依赖锁定与可复现构建等均有文档支撑,故 least_privilege、sensitive_data_handling、dependency_security 给高分。但用户确认多为文档描述而非代码证据,扣分;数据流透明仅覆盖部分路径;外部副作用(后台代理、网关、远程控制、Ledger 转账)面广而文档对默认行为说明有限,扣分;回滚仅提及单次 revert 与不可变发布,缺少面向用户的恢复流程,扣分;来源归属有 SBOM/attestation 描述但未在文件内直接可见,扣分。

可靠稳定11 / 14 · 3.9/5

失败信息设计详尽(稳定诊断码、doctor 报告),给高分。自一致性存在张力:README 称 17 个 provider 而描述称 25 个,版本号多处并存(0.19.19/0.3.0),扣分;依赖可用性依赖 Node 26.x 与私有运行时,宿主兼容面窄,扣分。

适用触发14 / 18 · 3.9/5

能力边界文档非常清晰(工具目录、沙箱覆盖矩阵、平台就绪状态),给高分。受众与场景覆盖终端/无头/后台/网关,但文档偏重维护者视角,扣分;触发精度依赖工具搜索与延迟加载,文档描述但无代码佐证,扣分;环境适配受 Linux/macOS 沙箱与 Windows fail-closed 限制,扣分。

规范维护14 / 18 · 3.9/5

信息架构与安装说明优秀,已知限制(Windows 无受限令牌、macOS 进程树局限)坦诚披露,给高分。命名稳定性因 provider 数量与版本表述不一致扣分;示例与 FAQ 偏少扣分;许可证仅 README 声明 MIT,未见 LICENSE 正文,扣分;版本与变更记录分散扣分;维护责任因发布者未验证、仅见贡献流程,给低分。

有效结果7 / 13 · 2.7/5

输出可用性有 TUI/print/stream-json 多形态,但缺少具体输出样例,扣分;边际价值有 Terminal-Bench 对比但为自述,扣分;成本效益仅单一基准数字且无独立佐证,给低分。

证据核验5 / 8 · 3.1/5

文档大量引用一手来源与 issue/PR 编号,claim_traceability 尚可;但基准成绩、成本对比仅指向自家站点,cross_source_corroboration 有限;事实与推断分离总体尚可但部分性能声明缺乏区分,均扣分。

风险与缓解建议
  • README 称 17 个内置 provider,而仓库描述称 25 个,存在不一致,需以代码为准核实。
  • Terminal-Bench 76.2%/$34 成绩仅指向自家站点,缺乏独立佐证,不应视为已验证。
  • Windows 无受限令牌隔离,受限执行会 fail-closed;macOS 进程树终止存在快照间隙,需评估平台风险。
  • 发布者身份未经验证,维护责任与更新路径不明确。
  • 安装依赖 curl | sh 与私有 Node 26.x 运行时,供应链与宿主兼容性需自行审查。
证据充分度:低 评估于 2026年10月26日 审查版本 56645d8190f8
查看完整评分方法 →

常见问题

软件本身要付费吗?
不需要。仓库以 MIT 许可发布,成本主要是你所选模型服务商的 API 费用;若使用 Ollama、LM Studio 等本地模型,则可进一步控制花费。
必须用 Grok 或 xAI 吗?
不必。默认服务商是 grok,但内置 17 个服务商,涵盖 openai、anthropic、gemini、deepseek、openrouter、amazon-bedrock 等,也可通过 Ollama 与 LM Studio 使用本地模型。
它会不会随意执行破坏性命令?
权限模式会限制 shell 与文件修改,OS 沙箱是可选项;文件修改工具强制先读后写并检查 mtime,apply_patch 具有事务性。可用 agenc security audit 检查配置。
可以在 CI 里无人值守运行吗?
可以。agenc --no-tui 或 agenc -p 提供无头一次性执行,--output-format 支持 json 与 stream-json,便于脚本消费;agenc daemon 也可由 AGENC_DAEMON_AUTOSTART=0 控制是否自动启动。
如何把它接入自己的程序?
两种方式:使用 @tetsuo-ai/agenc-sdk 以 socket 或子进程方式嵌入守护进程协议,或用 agenc mcp serve 将自身暴露为 MCP 服务端供其他 MCP 客户端调用。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

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

相关 Agents