GitHub

nWave Guides

User-facing documentation, organized by the four Divio documentation types. Each type serves a different need — pick the one that matches what you're trying to do right now.

Type When to use it Index
Tutorials You are learning nWave and want a guided, hands-on lesson Tutorials →
How-To Guides You have a specific job to do and want a recipe How-To Guides →
Reference You need precise specs for a verb, command, skill, agent, or config key Reference →
Explanation You want to understand why nWave works the way it does Explanation →

For your assistant

nwdes is your assistant's tool, not a command you type. It gives an LLM a deterministic delivery route: the tool itself builds each step — the handoff, role prompts, output schemas and packets — from typed values, so a wrong state cannot be written. It makes no model calls and enforces no gates. You talk to your assistant, point it at the right guide, and decide scope and trade-offs. The nwave-ai command line (install, doctor, attribution, backup and restore) is the person's tool.

To start a delivery, paste this sentence to your assistant:

Use your nw-nwdes skill if you have it, otherwise read https://github.com/nWave-ai/nWave/blob/main/docs/guides/nwdes/deliver-feature.md, then run its nwdes steps for me; ask me only for scope and trade-off decisions.

After nwave-ai install, a fresh assistant session can use nWave and nwdes on its own on the hosts that receive nWave's skills and agents:

Hosts A fresh session finds nwdes by itself?
Claude Code, OpenCode, OMP Yes — skills, agents and /nw-* commands are installed on the host
Codex Yes — skills, agents and hooks are installed; Codex has no /nw-* commands
Devin Partly — skills only; ask your assistant about the installed nw- skills
Cursor No — hooks only; point your assistant at the guide each session
Copilot No — agents, skills and hooks are installed; point your assistant at the guide each session

A person runs an nwdes command on purpose in three places: the nwdes --help check after install, the First feature with nwdes lesson (typed by hand once, to learn the command flow), and the terminal fallback on Cursor and Copilot.


New to nWave? Read What's new in v4 for a short map of how delivery works now, walk the safe First feature with nwdes lesson in a throwaway repository, then run real work with the Deliver a feature how-to. Terms you meet along the way are defined in the glossary.

Coming from 3.x? Follow Migrate from nWave 3.x.

Want the side-by-side? See v3 and v4 compared.