An open coding agent for your terminal, built by a community collective rather than a company. Bring your own model, keep your code on your machine, and owe nothing to anyone.
How to install nanocoder?
nano-collective/nanocoder
$git clone https://github.com/nano-collective/nanocoderInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install nanocoder by running `git clone https://github.com/nano-collective/nanocoder`, then use it for the current task and follow its documentation at https://github.com/nano-collective/nanocoder.
README.md
| 1 | # Nanocoder |
| 2 | |
| 3 | [简体中文](README.zh-CN.md) |
| 4 | [繁體中文](README.zh-TW.md) |
| 5 | |
| 6 | An open coding agent for your terminal, built by a community collective rather than a company. Bring your own model, keep your code on your machine, and owe nothing to anyone. |
| 7 | |
| 8 | Built by the [Nano Collective](https://nanocollective.org), a community collective building AI tooling not for profit, but for the community. Nanocoder runs agentic coding on the model of your choice: local models via Ollama, or any OpenAI-compatible API such as OpenRouter, Anthropic, and Google. You decide which provider runs your code and where your data goes. No closed-source features and no paid tiers gating the useful parts: **privacy-respecting**, **local-first**, and **open for all**. |
| 9 | |
| 10 |  |
| 11 | |
| 12 | --- |
| 13 |  |
| 14 |  |
| 15 |  |
| 16 |  |
| 17 |  |
| 18 |  |
| 19 |  |
| 20 |  |
| 21 | |
| 22 | <a href="https://www.star-history.com/#Nano-Collective/nanocoder&Date"> |
| 23 | <picture> |
| 24 | <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Nano-Collective/nanocoder&type=Date&theme=dark" /> |
| 25 | <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Nano-Collective/nanocoder&type=Date" /> |
| 26 | <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Nano-Collective/nanocoder&type=Date" /> |
| 27 | </picture> |
| 28 | </a> |
| 29 | |
| 30 | ## Quick Start |
| 31 | |
| 32 | ```bash |
| 33 | npm install -g @nanocollective/nanocoder |
| 34 | nanocoder |
| 35 | ``` |
| 36 | |
| 37 | Also available via [Homebrew](docs/getting-started/installation.md#homebrew-macoslinux) and [Nix Flakes](docs/getting-started/installation.md#nix-flakes). |
| 38 | |
| 39 | ### CLI Flags |
| 40 | |
| 41 | Specify provider, model, and starting mode directly: |
| 42 | |
| 43 | ```bash |
| 44 | # Non-interactive mode with specific provider/model |
| 45 | nanocoder --provider openrouter --model google/gemini-3.1-flash run "analyze src/app.ts" |
| 46 | |
| 47 | # Interactive mode starting with specific provider |
| 48 | nanocoder --provider ollama --model llama3.1 |
| 49 | |
| 50 | # Flags can appear before or after 'run' command |
| 51 | nanocoder run --provider openrouter "refactor database module" |
| 52 | |
| 53 | # Boot directly into a development mode (normal, auto-accept, yolo, plan) |
| 54 | nanocoder --mode yolo |
| 55 | nanocoder --mode plan run "audit the auth module" |
| 56 | |
| 57 | # Fullscreen mode with in-app scrolling instead of the inline default |
| 58 | nanocoder --alt-screen |
| 59 | ``` |
| 60 | |
| 61 | ### Screen Modes |
| 62 | |
| 63 | Nanocoder supports two rendering modes, mirroring what Claude Code and Codex ship: |
| 64 | |
| 65 | - **Inline (default)** — renders on the main screen; finished messages print once into the terminal's native scrollback, so your terminal's scrollbar, mouse wheel, and search work as usual. The transcript stays in the terminal after you exit. |
| 66 | - **Fullscreen** (`--alt-screen` flag, or `"alternateScreen": true` in preferences) — a fixed-height layout on the alternate screen buffer with in-app scrolling: mouse wheel and PgUp/PgDn, with a scroll indicator and automatic snap-back to bottom on new output. `--no-alt-screen` forces inline mode even if the preference is set. |
| 67 | |
| 68 | In both modes, `/clear` fully resets the terminal to a fresh welcome banner, and exiting (Ctrl+C or `/exit`) erases the input UI cleanly, leaving the transcript and a farewell instead of a dead input box. |
| 69 | |
| 70 | ## Documentation |
| 71 | |
| 72 | Full documentation is available online at **[docs.nanocollective.org](https://docs.nanocollective.org/nanocoder/docs)** or in the [docs/](docs/) folder: |
| 73 | |
| 74 | - **[Getting Started](docs/gett |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
