nWave

nWave

AI agents that guide you from idea to working code, with you in control at every step.

Stars: 108

Visit
 screenshot

nWave is a tool that uses AI agents to guide users from idea to working code. Users describe what to build, and specialized agents handle requirements, architecture, test design, and implementation. The tool ensures user control at every step, with review and approval required at each stage. The workflow consists of six waves, each producing artifacts that users review before proceeding to the next wave. nWave runs inside Claude Code and offers commands for different stages of development, such as requirements discussion, architecture design, acceptance tests, and implementation.

README:

nWave

AI agents that guide you from idea to working code — with you in control at every step.

nWave runs inside Claude Code. You describe what to build. Specialized agents handle requirements, architecture, test design, and implementation. You review and approve at each stage.

Quick Start

1. Install (in your terminal — not inside Claude Code):

pipx install nwave-ai
nwave-ai install

No repository clone needed. This installs nWave from PyPI and sets up agents and commands in ~/.claude/.

Don't have pipx? Install it first: pip install pipx && pipx ensurepath, then restart your terminal. pipx docs. Windows users: Use WSL, not cmd.exe or PowerShell. Install WSL first: wsl --install

Full setup details: Installation Guide

2. Use (inside Claude Code, after reopening it):

/nw:discuss "user login with email and password"   # Requirements
/nw:design --architecture=hexagonal                 # Architecture
/nw:distill "user-login"                            # Acceptance tests
/nw:deliver                                         # TDD implementation

Four commands. Four human checkpoints. One working feature.

Full walkthrough: Your First Feature

How It Works

  machine        human         machine        human         machine
    │              │              │              │              │
    ▼              ▼              ▼              ▼              ▼
  Agent ──→ Documentation ──→ Review ──→ Decision ──→ Agent ──→ ...
 generates    artifacts      validates   approves    continues

Each wave produces artifacts that you review before the next wave begins. The machine never runs unsupervised end-to-end.

The full workflow has six waves. Use all six for greenfield projects, or jump straight to /nw:deliver for brownfield work.

Wave Command Agent Produces
DISCOVER /nw:discover product-discoverer Market validation
DISCUSS /nw:discuss product-owner Requirements
DESIGN /nw:design solution-architect Architecture + ADRs
DEVOPS /nw:devops platform-architect Infrastructure readiness
DISTILL /nw:distill acceptance-designer Given-When-Then tests
DELIVER /nw:deliver software-crafter Working implementation

22 agents total: 6 wave agents, 5 cross-wave specialists, 11 peer reviewers. Full list: Commands Reference

Documentation

Getting Started

Guides & Reference

Community

License

MIT — see LICENSE for details.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for nWave

Similar Open Source Tools

For similar tasks

For similar jobs