by nWave-ai
AI agents that guide you from idea to working code, with you in control at every step.
# Add to your Claude Code skills
git clone https://github.com/nWave-ai/nWaveAI 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.
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
Staying updated — nWave checks for new versions when you open Claude Code. When an update is available, you'll see a note in Claude's context with the version and what changed. To update, run two commands in your terminal: pip install --upgrade nwave-ai (pulls the new package), then nwave-ai install (deploys the new framework files). To control check frequency: set update_check.frequency in ~/.nwave/des-config.json (daily / weekly / every_session / never).
2. Use (inside Claude Code, after reopening it):
No comments yet. Be the first to share your thoughts!
/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
nWave enforces proven engineering practices — TDD, peer review, mutation testing — at every step. /nw:rigor lets you scale the depth of those practices to match the stakes of your work. A config tweak doesn't need the same investment as a security-critical feature. You pick the profile; nWave enforces it everywhere.
/nw:rigor # Interactive: compare profiles, pick one
/nw:rigor lean # Quick switch: apply immediately
/nw:rigor custom # Build your own: choose each setting
| Profile | Agent | Reviewer | Review | TDD | Mutation | Est. Cost | When to Use | |---------|-------|----------|--------|-----|----------|-----------|-------------| | lean | haiku | -- | no | R→G | no | lowest | Spikes, config, docs | | standard ⭐ | sonnet | haiku | single | full 5-phase | no | moderate | Most work | | thorough | opus | sonnet | double | full 5-phase | no | higher | Critical features | | exhaustive | opus | opus | double | full 5-phase | ≥...