nWave

AI agents that guide you from idea to working code, with human judgment at every gate.

nWave runs inside Claude Code. It breaks feature delivery into seven waves (discover, diverge, discuss, design, devops, distill, deliver). Specialized agents produce artifacts at each wave. You review and approve before proceeding.

Documentation: docs.nwave.ai — guides, reference, and explanations, versioned per release.

Install in 5 Minutes

Requirements: Python 3.10+ and Claude Code.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/nWave-ai/nWave/main/scripts/install/install.sh)"

This installs the nwave-ai CLI and wires nWave into Claude Code in one step. It uses uv when available (recommended); pipx is supported but not recommended. Restart Claude Code when it finishes.

Need CLI flags, environment variables, CI/non-interactive use, or manual and offline steps? See the Installation Guide.

Your First Command

Inside Claude Code, type:

/nw-buddy What should I do next?

The buddy reads your project and tells you which wave to start, where your artifacts are, and how to use nWave for your specific context. It works on day one with no configuration.

Before nWave: "Where do I start? Requirements doc or code first? Which agent?" After nWave: The buddy reads your project and gives you a concrete next step.

Using pipx, OpenCode, or Codex instead? See the Installation Guide.

Learn More

Resource	What it covers
Your First Feature	End-to-end walkthrough, zero to working code
Team Rollout Guide	Onboard a second developer onto an nWave project
Offline / Air-Gapped Install	Install nWave on a machine without PyPI access
Jobs To Be Done	Which wave fits your task
Wave Directory Structure	How artifacts are organized per feature
Feature Delta Format (L7)	Author features in the lean single-file model
Outcomes Registry	Catch duplicate rules and operations at design time
Configuring Doc Density	Control lean vs full wave output
Agents and Commands Reference	All agents and commands
Troubleshooting	Common issues and fixes

---

Latest Maintenance Release: v3.22.1

nWave v3.22.1 is the current corrective maintenance release for the v3 line. It carries forward the twelve community fixes that are already present in published 3.22.0, across installation, configuration, finalization, diagnostics, repository hygiene, command discovery, and contributor guidance:

Thank you to everyone in the community who reported these problems and helped make nWave better.