nca 原生 AI 编程 CLI

在终端中运行可恢复的 AI 编程会话,并通过子代理和 worktree 拆分任务。

Star 数
★ 205
最近更新
今天
License
MIT
主语言
Rust

30 秒速览

运行形态
命令行工具
可在哪里用
通用 · 跨平台OpenAI API · Claude API
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Rust 2024 edition(从源码构建时需要)Git(用于基于 worktree 的子会话)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
独立开发者想在一个终端中交互式编写代码、查看差异并切换 build、plan、review、fix 或 test 配置。
不适合
  • 需要桌面应用而非终端界面的团队
  • 要求所有模型调用都留在本机的团队

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

nca 是用 Rust 编写、以单个二进制文件交付的编程 CLI,主要通过全屏 TUI 或行式 REPL 操作,也支持一次性运行和分离式后台会话。运行时由 Supervisor 管理会话生命周期、审批、事件传递、IPC 和持久化;会话状态保存为 JSON 快照,事件记录保存为 JSONL。它可以启动带父子关系的子代理,并可为子会话创建独立 Git worktree。CLI 提供 JSON、NDJSON 和 Unix 套接字 IPC,既供人交互,也可由自动化程序驱动。默认使用 MiniMax,同时支持 OpenAI、Anthropic、OpenRouter、Alibaba DashScope 和自定义兼容端点;它是终端产品,不提供默认桌面或浏览器界面。

在工作区读取项目指导文件(包括 AGENTS.md、.ncarc 和 .nca/instructions.md),并根据配置加载内置工具和可选 MCP 工具。用户可通过 nca 启动交互会话,或运行 nca run --prompt 执行单次任务;也可用 nca spawn --prompt 创建分离会话,再通过 nca status、nca logs 和 nca attach 查看或接入。Agent 可调用文件读写、搜索、补丁、shell、web 等工具,向配置的模型提供商发送请求,并生成回复、工具事件及会话记录。Supervisor 持久化会话并通过 Unix 套接字处理控制;子代理可继承上下文并使用独立 worktree。自动化调用可选择 --json 或 --stream ndjson,桌面 ACP 客户端则可通过 nca acp 驱动同一个本地二进制。

  1. 独立开发者想在一个终端中交互式编写代码、查看差异并切换 build、plan、review、fix 或 test 配置。
  2. 维护者需要快速处理单项任务并退出,可用 nca run --prompt 执行前台任务。
  3. 开发者希望后台运行代码分析或计划,同时继续工作,再用 status、logs 或 attach 查看进度。
  4. 需要并行探索代码库的团队可启动带父子关系的子代理,并为子任务使用独立 Git worktree。
  5. 自动化或编排程序可用 JSON、NDJSON 和 Unix 套接字 IPC 启动任务并读取结构化事件。
  6. 研究者可运行 nca autoresearch once,执行带指标的实验并获取解析后的输出。

如何安装或部署这个 Agent?

macOS 和 Linux 可用安装脚本安装最新发布版;设置 NCA_VERSION 可固定版本,NCA_INSTALL_DIR 可更改安装目录。Windows 用户可下载对应 ZIP 并将 nca.exe 放入 PATH。源码构建需要较新的 Rust 工具链并支持 Rust edition 2024。

如何使用这个 Agent?

首次运行需配置一个受支持提供商的 API 密钥。下面以默认 MiniMax 提供商为例;之后可启动 TUI、运行一次性任务,或创建后台会话并查看状态。

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

优点
  • 单个 Rust 二进制文件提供 TUI、行式 REPL、一次性运行和分离式会话,适合终端工作流。
  • 会话快照、事件日志、恢复和 Unix 套接字 IPC 构成了可检查、可控制的持久运行模型。
  • 子代理支持父子关系和可选 Git worktree 隔离,且 CLI 有 JSON 与 NDJSON 输出。
  • 支持 MiniMax、OpenAI、Anthropic、OpenRouter、DashScope 和自定义端点,避免绑定单一模型提供商。
局限
  • 产品界面以终端为中心;README 明确说明默认路径没有桌面包装器或浏览器界面。
  • 典型使用需要提供商 API 密钥和网络连接;模型调用可能产生费用,且费用取决于所选提供商。
  • 源码构建要求 Rust edition 2024;worktree 子会话还依赖 Git。
  • macOS 桌面控制和录屏工具仅适用于 macOS,并要求系统辅助功能或屏幕录制权限。

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

README 将 nca 与 Claude Code、Grok CLI 和 Cursor CLI 做过启动与内存占用测量;其说明指出墙钟时间主要受各自模型影响,样本来自一台 Mac,且 nca 的测量版本早于 0.5.0。它强调的差异是 Rust 单二进制、较低客户端资源占用、持久会话和 worktree 子代理。

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

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
nca 原生 AI 编程 CLI 当前 59 · 缺口较多 命令行工具免费 + 模型费 ★ 205 今天 Rust OpenAI API · Claude API
zerostack 69 · 存在缺口 命令行工具免费 + 模型费 ★ 1.7k 4 天前 Rust OpenAI API · Claude API
Grok Build (grok CLI) 46 · 缺口较多 命令行工具免费 + 模型费 ★ 28k 1 个月前 Rust —
Oh My Pi 68 · 存在缺口 命令行工具免费 + 模型费 ★ 38k 今天 TypeScript Codex · OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
59/ 100 五分制 3.0 / 5
信任安全 13/29
可靠稳定 6/14
适用触发 14/18
规范维护 11/18
有效结果 10/13
证据核验 5/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

权限文档说明 safe、plan、deny/allow/ask、危险命令确认及会话级授权;ACP 在标准输入输出上服务,README 说明会话、日志、图片和配置路径,故最小权限、确认与数据流有实际支撑,但 bypass-permissions 可自动允许所有工具,MCP、钩子、搜索及执行命令会带来外部影响。敏感密钥可从环境变量读取且文档不推荐明文配置,但没有看到加密或更完整的秘密管理措施;依赖安全和恢复机制证据有限。仓库地址及 CI/release 流程可见,发布者身份与维护责任仍不清楚。

可靠稳定6 / 14 · 2.1/5

文档描述重试、超时、输出截断错误及 MCP 传输限制,支持一定的失败处理;CI 配置列出格式检查、Clippy、构建和测试,但本评估未执行它们。材料存在不一致:README 版本为 0.66.0,而配置示例中用户代理仍标为 0.5;存储路径和功能说明也有旧新混用。Cargo workspace 声明 Rust 2024,但未提供锁文件或依赖审计证据。

适用触发14 / 18 · 3.9/5

README 对个人终端使用、单次任务、后台会话、多代理、自动化、研究任务及 ACP 客户端给出具体场景;权限模式、TTY/REPL 切换、多个提供商和可配置 MCP 展示了适配面。能力边界有说明,如 macOS 专属 GUI/录屏、受支持的 ACP 传输及图片模型要求,但大量可执行能力和模式选择仍要求用户自行配置与判断。

规范维护11 / 18 · 3.1/5

文档有分层目录、快速开始、命令表、配置参考和可操作示例;安装说明覆盖脚本、发行包和源码,并列出 Rust 与 Git 等前提。已提供 MIT workspace 元数据、版本号及变更记录。扣分原因包括文档中旧版本和路径残留、FAQ/已知限制并不完整,且发布者维护责任与更新联系路径未在材料中明确。

有效结果10 / 13 · 3.8/5

产品提供 TUI、REPL、单次运行、持久会话、JSON/NDJSON、IPC、工作树子代理及 ACP,结构化输出和会话管理有利于人和编排器使用。多提供商、长会话上下文管理和研究辅助可带来额外价值;但需要外部模型 API 与密钥,且工作树、MCP、钩子和权限配置增加上手与维护成本。未执行运行,不能验证声称的效果。

证据核验5 / 8 · 3.1/5

README 的主要功能和安全说明可在权限文档、CLI 参数、ACP 入口、Cargo workspace 及 CI/release 配置中找到部分对应,具备一定交叉佐证。材料清楚列出若干实现路径和配置项,但许多性能、功能兼容性和安全效果仍是文档陈述;没有把这些陈述与本次执行验证混为一谈。

风险与缓解建议
  • bypass-permissions 会自动放行所有工具;使用前应确认提示内容、MCP 服务和钩子命令可信。
  • 安装脚本通过 curl 管道交给 bash;密钥依赖外部模型提供商,配置示例也允许直接写入密钥。
  • 文档含有旧版本或路径信息;本次仅作静态审阅,未运行构建、测试或安装流程。
证据充分度:低 评估于 2026年11月7日 审查版本 fce6abaef3d8 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

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

FARS

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

最近版本

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

  1. v0.66.0
    发布说明摘录
    What's Changed * feat: add regex option search (#11), Alibaba DashScope provider (#20), and test isolation by @adisusilayasa in https://github.com/madebyaris/native-cli-ai/pull/69 * Release v0.66.0 by @madebyaris in https://github.com/madebyaris/native-cli-ai/pull/76 New Contributors * @adisusilayasa made their first contribution in https://github.com/madebyaris/native-cli-ai/pull/69 Full Changelog: https://github.com/madebyaris/native-cli-ai/compare/v0.65.0...v0.66.0
    在 GitHub 查看 ↗
  2. v0.65.0
    发布说明摘录
    What's Changed * feat(web_search): add Keenable backend (keyless, optional key) by @KGKallasmaa in https://github.com/madebyaris/native-cli-ai/pull/75 New Contributors * @KGKallasmaa made their first contribution in https://github.com/madebyaris/native-cli-ai/pull/75 Full Changelog: https://github.com/madebyaris/native-cli-ai/compare/v0.6.0...v0.65.0
    在 GitHub 查看 ↗
  3. v0.6.0
    发布说明摘录
    What's Changed * Release v0.6.0: per-model cost, compaction that keeps the conversation, search fallback by @madebyaris in https://github.com/madebyaris/native-cli-ai/pull/72 Full Changelog: https://github.com/madebyaris/native-cli-ai/compare/v0.5.5...v0.6.0
    在 GitHub 查看 ↗

常见问题

运行 nca 是否需要付费?
README 未说明 nca 软件的收费方式。实际使用需要配置模型提供商凭据;API 使用费用由所选提供商决定。
nca 只能使用 MiniMax 吗?
不是。MiniMax 是默认提供商路径;README 也列出 OpenAI、Anthropic、OpenRouter、Alibaba DashScope 和自定义端点。
它能在没有终端的桌面客户端中使用吗?
可以通过 nca acp 将本地二进制作为 Agent Client Protocol 服务运行,README 列出 T3 Code、Termul 和 Zed 等客户端。产品本身仍以 CLI 为主。
工具操作会自动执行吗?
权限模式会影响审批。文档称默认和 accept-edits 模式下普通 shell 命令可直接运行,但删除、sudo、git push 等危险操作仍会请求确认。
它支持完全离线运行吗?
README 描述的是向模型提供商发送请求的多提供商工作流,并未说明内置本地模型运行路径;因此不能据此确认完全离线使用。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

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