Skip to content

OMEE-Y/nanocoder

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,295 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nanocoder

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.

Built by the Nano Collective, 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.

Example


Build Status Coverage Version NPM Downloads NPM License Repo Size Stars Forks

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 - Skills (commands, subagents, tools, event triggers), the per-project daemon, 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

Why a collective

Nanocoder is built by the Nano Collective rather than a company, and that shapes the tool itself. There are no paid tiers, no telemetry quietly shipping your prompts somewhere, and no roadmap steered by what monetises best — the people building it are the people using it. Building in the open as a collective means the harness stays multi-provider on principle: you are never locked to one vendor's model, and the conventions, tests, and release standards are shared across every Nano Collective project so the work stays legible and contributable.

It is also bigger than one tool. The collective is assembling an open ecosystem of AI tooling — see the other projects — and contributors who show up now help shape what that becomes.

Community

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

About

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.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 98.8%
  • Other 1.2%