@nanocollective/nanocoder

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.

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, model, and starting mode 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"

# Boot directly into a development mode (normal, auto-accept, yolo, plan)
nanocoder --mode yolo
nanocoder --mode plan run "audit the auth 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.

• Contribute: See CONTRIBUTING.md for development setup and guidelines.
• The collective: nanocollective.org · docs · GitHub · Discord
• Support the work: The Support page covers donations and sponsorship.
• Paid contribution: The Economics Charter sets out how scoped paid bounties work.