NeuroSquad 终端控制台
在一个终端仪表板中运行并管理多个 AI 编码 CLI。
- Star 数
- ★ 53
- 最近更新
- 5 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 76/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeOpenAI API · Claude API(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 需要并行处理多个编码任务的开发者,可为 Claude Code、Codex 或 OpenCode 各启一个会话,并用 worktree 隔离改动。
- 不适合
- 需要稳定 1.0 版行为的团队
- 需要在 Windows ARM64 上使用语音听写的用户
- 源码审查
- 76/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
nsq 是一个 Node.js 命令行工具,可启动 Claude Code、Codex、OpenCode 或任意命令,并由每用户守护进程在后台管理其终端会话。终端仪表板将工作区和实时终端汇集到网格中,支持全屏查看、发送提示、回答权限问题和查看状态。支持的 CLI 可通过自身 hooks 报告“需要你”等状态与问题文本;普通命令只报告运行中或已完成。它还提供按代理隔离的 Git worktree、成本查看、通知、模型服务商配置、实验性手机访问和本地语音听写。工具运行在安装 nsq 的机器上,支持 Windows、macOS、Linux 和 SSH 场景;0.1.0 仍是预览版。
在项目目录中运行 nsq run claude "fix the flaky checkout test" --worktree 等命令,nsq 会启动相应 CLI,并可为代理创建独立分支和 worktree;也可用 nsq run -- <command…> 启动任意命令。每用户守护进程持有终端会话,因此关闭仪表板后任务仍可运行,之后可用 nsq 重新连接。仪表板展示工作区、终端输出和状态,可打开代理全屏、发送提示、打断任务以及回答权限请求;nsq ls、nsq answer、nsq diff 和 nsq cost 提供脚本化管理。用户还可配置 OpenRouter 或兼容 OpenAI/Anthropic API 的自有模型服务器,并查看审批日志和通知。
- 需要并行处理多个编码任务的开发者,可为 Claude Code、Codex 或 OpenCode 各启一个会话,并用 worktree 隔离改动。
- 在 SSH 或远程 Linux 服务器上工作的工程师,可让守护进程在终端断开后继续运行代理。
- 希望集中查看权限请求的团队成员,可在仪表板中读取问题并直接批准、始终允许或拒绝。
- 使用本地或自建模型服务器的开发者,可添加 Ollama、LM Studio、llama.cpp 或兼容 API 服务并选用其模型。
- 需要从手机查看代理状态或回答请求的用户,可选择启用实验性手机配对与局域网或 Cloudflare tunnel 访问。
如何安装或部署这个 Agent?
需要 Node.js 22.13 或更高版本。npm 全局安装或直接试用:
npm install -g neurosquad
nsq也可以不安装运行:
npx neurosquadREADME 还列出 Homebrew、Scoop 和安装脚本作为安装方式,但这里未给出具体命令。无需 API 密钥即可运行 nsq;使用 OpenRouter 或需密钥的自有模型服务时,再配置相应凭据。
如何使用这个 Agent?
在代码目录启动一个带独立 worktree 的 Claude Code 会话,再启动 Codex 并打开仪表板:
cd ~/code/my-app
nsq run claude "fix the flaky checkout test" --worktree
nsq run codex --name reviewer
nsq在仪表板中用方向键选择代理,按 Enter 全屏查看,按 Ctrl+] 返回;可用 y、a、n 回答权限请求,按 q 退出仪表板而让代理继续运行。也可用 CLI 管理会话:
nsq ls --json
nsq send reviewer "Review the checkout changes"
nsq answer reviewer yes
nsq diff reviewer
nsq cost使用 OpenRouter 时先设置密钥,再指定服务商和模型:
nsq openrouter set-key
nsq run claude --provider openrouter --model anthropic/claude-sonnet-4.5这个 Agent 有哪些优点和局限?
- 一个仪表板可同时管理多个 CLI 的实时终端,守护进程使会话在仪表板关闭后继续运行。
- 对支持的 harness 使用原生 hooks 报告等待状态,并展示具体权限问题文本。
--worktree可为代理创建独立分支和工作目录,减少并行改动冲突。- 支持 OpenRouter 与多种自有模型服务器,且可使用 CLI 自身登录运行。
- 提供本机语音识别和审批日志;README 称审批日志保留在本机。
- 0.1.0 是预览版,命令、按键和配置可能在 1.0 前变化。
- 要求 Node.js 22.13 或更高版本,用户还需自行安装所选编码 CLI 才能使用其专属 hooks 功能。
- 任意命令没有 harness hooks,因此状态只能显示运行中或已完成,不会显示“需要你”。
- 手机功能仍属实验阶段;远程在线访问依赖 Cloudflare tunnel,并要求用户每次选择启用。
- 语音听写在 Windows ARM64 上不可用,模型首次使用还需下载约 670 MB。
这个 Agent 与同类方案有什么区别?
README 将 nsq 与 NeuroSquad 桌面应用作了定位区分:nsq 面向偏好终端、SSH、Linux 服务器或轻量开源工具的用户;桌面应用提供画布界面、20 多种 CLI、代理间连线以及浏览器、笔记和插件卡片。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| NeuroSquad 终端控制台 当前 | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 53 | 5 天前 | TypeScript | Codex · Claude Code |
| Tessera | 74 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 315 | 今天 | TypeScript | Codex · Claude Code |
| OpenCode 电报机器人 | 64 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.3k | 1 天前 | TypeScript | — |
| Plannotator | 78 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 9.5k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 说明密钥放入系统钥匙串、审批日志留在本机并遮蔽疑似秘密;电话控制能力受限,远程访问需显式开启。对最小权限、确认和外部影响给 2 分:任意命令及代理本身仍可执行有影响的操作,且自动更新默认开启。数据流透明度给 3 分:文档逐项说明网络请求、日志内容及电话推送内容。敏感数据处理给 2 分:文档描述了保护措施,但未提供实现证据。依赖安全给 2 分:CI 动作固定到提交并有部分哈希校验,但材料未展示常规依赖审计。回滚给 2 分:有停止、移除和安全切换更新的说明,但没有通用恢复流程。来源归属给 2 分:许可证列出作者和贡献者并提供安全报告渠道,但发布者身份未验证。
文档、包元数据和工作流对 Node 版本、平台及预览状态大体一致,自洽性给 2 分;材料未显示实际运行结果。依赖可用性给 2 分:列出 Node 要求、预构建平台和支持的代理,但外部 CLI、网络及原生组件仍是条件。失败消息给 1 分:有故障排查文档和 doctor 命令说明,但未提供错误处理实现或消息样例。
受众和场景给 3 分:涵盖终端、SSH、并行代理、任意命令及多种模型服务。能力边界给 3 分:说明无钩子的命令不会报告等待状态、电话不能启动代理或输入任意按键,并标明电话实验性质。触发精度给 2 分:状态主要来自 CLI 钩子,同时用五分钟静默启发式识别可能卡住的情况,后者可能误报。环境适配给 3 分:说明 Windows、macOS、Linux、SSH、Node 版本及平台例外。
信息架构给 3 分:README 将安装、快速开始、命令、隐私和分主题指南清晰组织。安装说明给 3 分:提供 npm、npx、Node 版本及其他安装方式的文档入口。命名稳定性给 2 分:nsq 和 neurosquad-cli 基本可辨,但预览版明确提示命令、按键和配置可能变动。示例与常见问题给 3 分:有大量可直接参考的命令示例及故障排查入口。已知限制给 2 分:披露预览状态、实验功能、平台例外和状态识别边界,但未见集中完整的限制清单。许可证给 3 分:提供完整 MIT 文本并与元数据一致。版本及变更记录给 1 分:标明 0.1.0 预览并链接发布流程,但所给材料没有实际变更日志。维护责任给 2 分:有贡献、安全报告、支持版本和更新渠道说明,但发布者身份未验证。
输出可用性给 3 分:仪表板展示代理状态、问题、成本和审批记录,并提供脚本接口。边际价值给 3 分:统一管理长期运行的多个代理、状态和交互,README 具体描述了相对单独运行 CLI 的收益。成本效益给 2 分:软件开源且免费,但多代理运行、语音模型下载和后台守护进程会带来资源及维护成本,材料未量化这些成本。
声明可追溯性给 2 分:多数产品和隐私声明指向具体指南,CI 与实时端到端工作流描述了覆盖范围;但这些材料本身不能证明实际通过或实现效果。跨来源印证给 2 分:README、包元数据、许可证和工作流在若干基本事实上相互支持,但不足以独立验证核心功能。事实与推断区分给 2 分:文档标示实验功能、预览状态和启发式判断;仍有不少性能与安全保障只是项目自身声明。
- 这是 0.1.0 预览版;项目明确表示命令、按键和配置可能变化。
- 电话远程访问可控制代理,在线模式需显式开启;配对链接和令牌应按密码保管。
- 静默检测是启发式判断;README 也说明某些提示无法通过钩子精确识别。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Minor Changes - [#76](https://github.com/glmn-ai/neurosquad-cli/pull/76) [7383db9](https://github.com/glmn-ai/neurosquad-cli/commit/7383db901e93ed65c604295157adf9560d8d6b40) Thanks [@neurosquad-dev-bot](https://github.com/apps/neurosquad-dev-bot)! - The dashboard selects text and opens links itself. It holds the mouse, so the terminal couldn't do either: now a drag over an agent's text copies it (OSC 52, plus the system clipboard when local) and shows it inverted, and a click on an http(s) link opens it in the browser (copied instead over SSH). term-view gains linkAt, selectionText, …在 GitHub 查看 ↗ -
发布说明摘录
Minor Changes - [#76](https://github.com/glmn-ai/neurosquad-cli/pull/76) [7383db9](https://github.com/glmn-ai/neurosquad-cli/commit/7383db901e93ed65c604295157adf9560d8d6b40) Thanks [@neurosquad-dev-bot](https://github.com/apps/neurosquad-dev-bot)! - The dashboard selects text and opens links itself. It holds the mouse, so the terminal couldn't do either: now a drag over an agent's text copies it (OSC 52, plus the system clipboard when local) and shows it inverted, and a click on an http(s) link opens it in the browser (copied instead over SSH). term-view gains linkAt, selectionText, …在 GitHub 查看 ↗ -
发布说明摘录
Patch Changes - [#74](https://github.com/glmn-ai/neurosquad-cli/pull/74) [b70076e](https://github.com/glmn-ai/neurosquad-cli/commit/b70076e9d305f47b61273f5e2b10aaeca7a831fb) Thanks [@neurosquad-dev-bot](https://github.com/apps/neurosquad-dev-bot)! - Prices GPT-6 Astra, GPT-6 Sol, GPT-6.1 Sol and GPT-6 Luna (OpenAI's list prices, with their rates above 272K prompt tokens). Codex's codex-auto-review and gpt-5.3-codex-spark have no published price and stay "no price". The price table is now dated 2026-10-13. …在 GitHub 查看 ↗
常见问题
运行 nsq 一定要有付费模型账号吗?
关闭终端或仪表板时,代理会停止吗?
nsq down 会停止守护进程和代理。nsq 能准确识别所有命令何时需要我批准吗?
手机访问默认开启吗?
nsq phone on 并配对;通过 Cloudflare tunnel 从外网访问也需显式使用 --online。