Installation

For Users

NPM

Install globally and use anywhere:

npm install -g @nanocollective/nanocoder

Then run in any directory:

nanocoder

Homebrew (macOS/Linux)

First, tap the repository:

brew tap nano-collective/nanocoder https://github.com/Nano-Collective/nanocoder

Then install:

brew install nanocoder

Run in any directory:

nanocoder

To update:

# Update Homebrew's tap cache first (important!)
brew update

# Then upgrade nanocoder
brew upgrade nanocoder

Note: If brew upgrade nanocoder shows the old version is already installed, run brew update first. Homebrew caches tap formulas locally and only refreshes them during brew update. Without updating the tap cache, you'll see the cached (older) version even if a newer formula exists in the repository.

Nix Flakes

Run Nanocoder directly using:

# If you have flakes enabled in your Nix config:
nix run github:Nano-Collective/nanocoder

# If you don't have flakes enabled:
nix run --extra-experimental-features 'nix-command flakes' github:Nano-Collective/nanocoder

Or install from packages output:

# flake.nix
{
  inputs = {
    nanocoder = {
      url = "github:Nano-Collective/nanocoder";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
}

# configuration.nix
{ pkgs, inputs, system, ... }: {
  environment.systemPackages = [
    inputs.nanocoder.packages."${system}".default
  ];
}

For Development

If you want to contribute or modify Nanocoder:

Prerequisites:

• Node.js 22+
• pnpm (managed via Corepack — pinned by the repo's packageManager field, no manual install needed)

Corepack ships with Node 22. If pnpm isn't found, run corepack enable once. To bump pnpm for the project later, run corepack use pnpm@latest.

Setup:

1. Clone and install dependencies:

git clone [repo-url]
cd nanocoder
pnpm install

2. Build the project:

pnpm run build

3. Run locally:

pnpm run start

Or build and run in one command:

pnpm run dev