How to install nanostack

One command. Works with Claude Code, Cursor, Codex, Gemini CLI, Amp, Cline, OpenCode, and Antigravity.

Install

Run the installer from any directory. It detects which AI agents you have installed, clones the repo, sets up symlinks so every agent can find the skills, and verifies the result.

npx create-nanostack

That single command handles everything. No global installs, no config files to edit manually.

What it does, step by step

  1. Detects agents— scans for Claude Code, Cursor, Codex, Gemini CLI, Amp, Cline, OpenCode, and Antigravity. It only configures the ones it finds.
  2. Clones the repo— pulls the latest release to ~/.nanostack.
  3. Creates symlinks— links skill files into each agent's expected location so they're available as slash commands.
  4. Verifies— runs a quick check that every skill loads correctly and prints a summary.

Verify the installation

If you want to re-run the verification step later, or if something feels off:

npx create-nanostack doctor

This checks symlinks, file permissions, agent configs, and reports anything that needs attention.

Gemini CLI alternative

If you only use Gemini CLI, you can install nanostack as an extension directly:

gemini extensions install https://github.com/garagon/nanostack --consent

This skips the multi-agent detection and installs nanostack only for Gemini. The standard npx create-nanostack method also supports Gemini CLI, so use whichever you prefer.

Update

Two options. From your terminal:

npx create-nanostack update

Or from inside any supported agent:

/nano-update

Both pull the latest skills and re-run the symlink step. Your local customizations in ~/.nanostack/custom/ are preserved.

Requirements

  • Node.js 18+ — for the npx installer
  • git — to clone and update the repo
  • jq — used by some bin/ scripts for JSON processing
  • macOS, Linux, or Windows(Git Bash or WSL) — native Windows cmd is not supported

Most developer machines already have these. If npx create-nanostack doctor flags a missing dependency, install it with your system package manager and re-run.

NextFirst sprint →