neurogrid's terminal coding agent · free · open source
A coding agent that lives in your shell. Ask it to explain a repository, fix a failing test, or make a change, and it reads the code, edits files and runs your commands until the job is done.
Install
uv tool install nrgrd nrgrd
macOS, Linux and Windows. Python 3.11 or newer. Also installable with pipx and pip — see the install guide. On first run it asks for an endpoint and API key, then picks the model the endpoint serves.
Open it where you work
Run nrgrd inside a project and it reads the room: your git branch, the language, the package manager, the test runner. No setup files, no indexing step, nothing to configure per repository.
It does the work, not just the talking
It searches the codebase, reads the files that matter, makes the edit, runs your tests, reads the failure and tries again. You give it the goal; it decides which files to open.
nrgrd "find the bug making the test fail and fix it"
The same command works without the interface, so it fits in a script or a CI job.
Sessions and slash commands
Each project keeps its own conversation, so you can stop and pick the task back up tomorrow. Name several and switch between them. /diff shows what changed, /context how much room is left, and long conversations are summarised automatically before they overflow.
It asks before it touches anything
Reading, searching and git inspection just run. Writing a file or running a shell command stops and asks you first, and you can approve a tool for the rest of the session. Ctrl+C interrupts a generation or a running command without corrupting the conversation.
Your API key goes to your operating system's credential store where there is one, never into a config file, and nrgrd sends no telemetry: your prompts go to the endpoint you configured and nowhere else.
Your model, your machine
nrgrd talks to any OpenAI-compatible endpoint: a Neurogrid deployment running on a community GPU, or your own vLLM, Ollama or LM Studio. Point it somewhere else whenever you like — it is a client, not a subscription. You can also connect MCP servers, and their tools go through the same approval flow.
Free, and open source
nrgrd costs nothing and the whole thing is on GitHub under the MIT license: read it, fork it, ship it in your own product. Issues and pull requests are welcome, and a star helps other people find it.