An open-source AI coding agent that runs in your terminal, with companion desktop, web, editor, and chat interfaces.
Nano-Collective/nanocoder
An open-source coding agent for the terminal that runs on local models via Ollama or any OpenAI-compatible API.
Open-source alternative to:Claude Code
Codex CLI
- Stars
- 2,530
- Forks
- 369
- Open issues
- 246
- Last commit
- yesterday
What is it?
Nanocoder is a coding agent that runs in your terminal. You choose the model: local models through Ollama, or hosted providers exposing an OpenAI-compatible API such as OpenRouter, Requesty, Anthropic, and Google. Because you pick the provider, you decide where your code and prompts are sent.
It is built by the Nano Collective, a community group rather than a company, and the project states it has no paid tiers and no closed-source features. It offers non-interactive runs with a prompt, development modes including auto-accept, plan, and architect, and commands to review a branch or PR and to open a PR in an isolated git worktree for a session.
The interface has a fullscreen mode with in-app scrolling and an inline mode that keeps the transcript in the terminal's native scrollback.
Key features
- 01Runs with local models via Ollama or hosted models through OpenAI-compatible APIs.
- 02Non-interactive mode for one-off prompts, plus an interactive terminal session.
- 03Development modes including normal, auto-accept, yolo, plan, and architect.
- 04Reviews a branch or PR diff for bugs, security issues, and style violations.
- 05Opens a PR in an isolated git worktree for a coding session.
- 06Fullscreen and inline screen modes.
Use cases
- Working on proprietary code while keeping prompts on your own machine with a local model.
- Reviewing a branch or pull request from the terminal before merging.
- Making changes to a PR in a separate worktree without disturbing your current checkout.
Quick start
- 1
Install globally via npm
npm install -g @nanocollective/nanocoder - 2
Launch nanocoder in your terminal
nanocoder
Things to know
- License is listed as NOASSERTION in metadata, so check the repository license before commercial use.
- Using local models requires Ollama or an OpenAI-compatible API, which you must set up yourself.
Topics
FAQ
- What is nanocoder?
- An open-source coding agent for the terminal that runs on local models via Ollama or any OpenAI-compatible API. Nanocoder is a coding agent that runs in your terminal. You choose the model: local models through Ollama, or hosted providers exposing an OpenAI-compatible API such as OpenRouter, Requesty, Anthropic, and Google. Because you pick the provider, you decide where your code and prompts are sent.
- Is nanocoder free to use? What license does it have?
- nanocoder is open source under the Other license. Check the license terms before using it in commercial products.
- Is nanocoder still maintained?
- Actively maintained. The last commit to nanocoder was on Oct 21, 2026.
- What can I use nanocoder for?
- Working on proprietary code while keeping prompts on your own machine with a local model. Reviewing a branch or pull request from the terminal before merging. Making changes to a PR in a separate worktree without disturbing your current checkout.
- How do I install nanocoder?
- Install globally via npm: npm install -g @nanocollective/nanocoder Launch nanocoder in your terminal: nanocoder
- Where can I get nanocoder?
- The source code and installation instructions are on GitHub: https://github.com/Nano-Collective/nanocoder
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A terminal-based AI coding agent in Rust that works with many LLM providers, offering a TUI, one-shot CLI, and ZSH plugin modes.
A local-first, evidence-first AI coding terminal that connects LLMs to real project files, tools, permissions, verification and context.
An open-source coding-agent CLI that runs in the terminal and works with cloud APIs and local model backends like Ollama.
Open-source Rust coding agent for the terminal that edits files, runs commands and works with 40+ model providers, including local models.
Z.ai's AI coding workspace offering a desktop app, browser UI, and terminal agent, built on a shared TypeScript codebase.