Nanocoder

A local-first CLI coding agent built by the Nano Collective — a community collective building AI tooling not for profit, but for the community. Everything we build is open, transparent, and driven by the people who use it. AI done right.

Nanocoder brings the power of agentic coding tools like Claude Code and Gemini CLI to local models or controlled APIs like OpenRouter. Built with privacy and control in mind, it supports multiple AI providers with tool support for file operations and command execution.

---

Quick Start

npm install -g @nanocollective/nanocoder
nanocoder

Also available via Homebrew and Nix Flakes.

CLI Flags

Specify provider and model directly:

# Non-interactive mode with specific provider/model
nanocoder --provider openrouter --model google/gemini-3.1-flash run "analyze src/app.ts"

# Interactive mode starting with specific provider
nanocoder --provider ollama --model llama3.1

# Flags can appear before or after 'run' command
nanocoder run --provider openrouter "refactor database module"

Documentation

Full documentation is available online at docs.nanocollective.org or in the docs/ folder:

• Getting Started - Installation, setup, and first steps
• Configuration - AI providers, MCP servers, preferences, logging, timeouts
• Features - Custom commands, checkpointing, development modes, task management, and more
• Commands Reference - Complete list of built-in slash commands
• Keyboard Shortcuts - Full shortcut reference
• Community - Contributing, Discord, and how to help

Community

The Nano Collective is a community collective building AI tooling for the community, not for profit. We'd love your help!

• Contributing: See CONTRIBUTING.md for development setup and guidelines
• Discord: Join our server to connect with other users and contributors
• GitHub: Open issues or join discussions on our repository