Quick Start
Get Wave running on your project in 5 minutes.
1. Initialize Project
bash
cd your-project
wave initThe interactive wizard guides you through adapter selection and pipeline configuration. On success, you'll see:
╦ ╦╔═╗╦ ╦╔═╗
║║║╠═╣╚╗╔╝║╣
╚╩╝╩ ╩ ╚╝ ╚═╝
Multi-Agent Pipeline Orchestrator
Project initialized successfully!
Created:
wave.yaml Main manifest
.wave/personas/ 5 persona archetypes
.wave/pipelines/ 12 pipelines
.wave/contracts/ 4 JSON schema validators
.wave/prompts/ 8 prompt templates
.wave/workspaces/ Ephemeral workspace root
.wave/traces/ Audit log directory
Next steps:
1. Run 'wave validate' to check configuration
2. Run 'wave run ops-hello-world "test"' to verify setup
3. Run 'wave run plan-task "your feature"' to plan a task2. Review Configuration
yaml
# wave.yaml
apiVersion: v1
kind: WaveManifest
metadata:
name: my-project
description: "Example project"
adapters:
claude:
binary: claude
mode: headless
output_format: json
personas:
navigator:
adapter: claude
system_prompt_file: .wave/personas/navigator.md
temperature: 0.1
permissions:
allowed_tools: ["Read", "Bash(git *)"]
deny: ["Write(*)"]
runtime:
workspace_root: .wave/workspaces
max_concurrent_workers: 33. Validate Configuration
bash
wave validateExpected output:
✓ Manifest validation passed
✓ All persona system prompt files exist
✓ Adapter binaries found on PATH4. Run First Pipeline
bash
wave run ops-hello-world "testing Wave"The default TUI shows a progress bar and spinners. For text output, use -o text:
bash
wave run ops-hello-world "testing Wave" -o text[10:00:01] → greet (craftsman)
[10:00:01] greet: Executing agent
[10:00:05] ✓ greet completed (4.0s, 0k tokens)
[10:00:05] → verify (navigator)
[10:00:12] ✓ verify completed (6.9s, 0k tokens)5. Check Results
Artifacts are saved in .wave/workspaces/<pipeline-id>/<step-id>/. Each step produces its own workspace.
Quick Commands
bash
# Ad-hoc task (no full pipeline)
wave do "fix typo in README"
# Resume from a specific step
wave run impl-speckit --from-step implement
# Clean up workspaces
wave clean