nca 原生 AI 编程 CLI
在终端中运行可恢复的 AI 编程会话,并通过子代理和 worktree 拆分任务。
- Star 数
- ★ 205
- 最近更新
- 今天
- License
- MIT
- 主语言
- Rust
- FA 评分
- 59/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 独立开发者想在一个终端中交互式编写代码、查看差异并切换 build、plan、review、fix 或 test 配置。
- 不适合
- 需要桌面应用而非终端界面的团队
- 要求所有模型调用都留在本机的团队
- 源码审查
- 59/100 · 缺口较多
这个 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 驱动同一个本地二进制。
- 独立开发者想在一个终端中交互式编写代码、查看差异并切换 build、plan、review、fix 或 test 配置。
- 维护者需要快速处理单项任务并退出,可用 nca run --prompt 执行前台任务。
- 开发者希望后台运行代码分析或计划,同时继续工作,再用 status、logs 或 attach 查看进度。
- 需要并行探索代码库的团队可启动带父子关系的子代理,并为子任务使用独立 Git worktree。
- 自动化或编排程序可用 JSON、NDJSON 和 Unix 套接字 IPC 启动任务并读取结构化事件。
- 研究者可运行 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?
查看各维度的扣分理由
权限文档说明 safe、plan、deny/allow/ask、危险命令确认及会话级授权;ACP 在标准输入输出上服务,README 说明会话、日志、图片和配置路径,故最小权限、确认与数据流有实际支撑,但 bypass-permissions 可自动允许所有工具,MCP、钩子、搜索及执行命令会带来外部影响。敏感密钥可从环境变量读取且文档不推荐明文配置,但没有看到加密或更完整的秘密管理措施;依赖安全和恢复机制证据有限。仓库地址及 CI/release 流程可见,发布者身份与维护责任仍不清楚。
文档描述重试、超时、输出截断错误及 MCP 传输限制,支持一定的失败处理;CI 配置列出格式检查、Clippy、构建和测试,但本评估未执行它们。材料存在不一致:README 版本为 0.66.0,而配置示例中用户代理仍标为 0.5;存储路径和功能说明也有旧新混用。Cargo workspace 声明 Rust 2024,但未提供锁文件或依赖审计证据。
README 对个人终端使用、单次任务、后台会话、多代理、自动化、研究任务及 ACP 客户端给出具体场景;权限模式、TTY/REPL 切换、多个提供商和可配置 MCP 展示了适配面。能力边界有说明,如 macOS 专属 GUI/录屏、受支持的 ACP 传输及图片模型要求,但大量可执行能力和模式选择仍要求用户自行配置与判断。
文档有分层目录、快速开始、命令表、配置参考和可操作示例;安装说明覆盖脚本、发行包和源码,并列出 Rust 与 Git 等前提。已提供 MIT workspace 元数据、版本号及变更记录。扣分原因包括文档中旧版本和路径残留、FAQ/已知限制并不完整,且发布者维护责任与更新联系路径未在材料中明确。
产品提供 TUI、REPL、单次运行、持久会话、JSON/NDJSON、IPC、工作树子代理及 ACP,结构化输出和会话管理有利于人和编排器使用。多提供商、长会话上下文管理和研究辅助可带来额外价值;但需要外部模型 API 与密钥,且工作树、MCP、钩子和权限配置增加上手与维护成本。未执行运行,不能验证声称的效果。
README 的主要功能和安全说明可在权限文档、CLI 参数、ACP 入口、Cargo workspace 及 CI/release 配置中找到部分对应,具备一定交叉佐证。材料清楚列出若干实现路径和配置项,但许多性能、功能兼容性和安全效果仍是文档陈述;没有把这些陈述与本次执行验证混为一谈。
- bypass-permissions 会自动放行所有工具;使用前应确认提示内容、MCP 服务和钩子命令可信。
- 安装脚本通过 curl 管道交给 bash;密钥依赖外部模型提供商,配置示例也允许直接写入密钥。
- 文档含有旧版本或路径信息;本次仅作静态审阅,未运行构建、测试或安装流程。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
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 查看 ↗ -
发布说明摘录
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 查看 ↗ -
发布说明摘录
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 是否需要付费?
nca 只能使用 MiniMax 吗?
它能在没有终端的桌面客户端中使用吗?
工具操作会自动执行吗?
它支持完全离线运行吗?
谢谢反馈,我们会据此改进页面。