███╗   ██╗██████╗  ██████╗ ██████╗ ██████╗
████╗  ██║██╔══██╗██╔════╝ ██╔══██╗██╔══██╗
██╔██╗ ██║██████╔╝██║  ███╗██████╔╝██║  ██║
██║╚██╗██║██╔══██╗██║   ██║██╔══██╗██║  ██║
██║ ╚████║██║  ██║╚██████╔╝██║  ██║██████╔╝
╚═╝  ╚═══╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═════╝

安装

uv tool install nrgrd
nrgrd

支持 macOS、Linux 和 Windows，需要 Python 3.11 或更高版本。也可以用 pipx 和 pip 安装，详见安装指南。首次运行时会要求填写 endpoint 和 API key，然后自动选择该 endpoint 提供的模型。

在你工作的地方打开它

在项目里运行 nrgrd，它会自动了解环境：你的 git 分支、编程语言、包管理器和测试工具。不需要配置文件，没有索引步骤，也不用为每个仓库单独设置。

它真的动手，而不只是动嘴

它会搜索代码库、阅读关键文件、做出修改、运行你的测试、查看失败原因并再次尝试。你给出目标，它决定打开哪些文件。

nrgrd "找到导致测试失败的 bug 并修复它"

同样的命令也能在没有界面的情况下运行，因此可以放进脚本或 CI 任务里。

会话与斜杠命令

每个项目都保留自己的对话，你可以随时停下，明天再继续。可以为多个会话命名并在它们之间切换。/diff 显示改动了什么，/context 显示还剩多少空间，过长的对话会在溢出前自动总结。

动手之前先征求你的同意

读取、搜索和查看 git 会直接执行。写入文件或运行 shell 命令前会先停下来询问你，你也可以在本次会话中一直允许某个工具。Ctrl+C 可以中断生成或正在运行的命令，而不会破坏对话。

你的 API key 会存放在操作系统的凭据存储中（如果有的话），绝不会写进配置文件；nrgrd 也不发送任何遥测数据：你的提示只会发送到你配置的 endpoint，不会去别的地方。

你的模型，你的机器

nrgrd 可以连接任何兼容 OpenAI 的 endpoint：运行在社区 GPU 上的 Neurogrid 部署，或你自己的 vLLM、Ollama、LM Studio。随时可以切换到别处——它是一个客户端，而不是订阅服务。你还可以连接 MCP 服务器，它们的工具同样会经过审批流程。