WrongStack Examples

Working examples organized by complexity. Each subdirectory shows one WrongStack capability with commands you can copy-paste verbatim — every flag, slash command, and model id is verified against the live models.dev/api.json catalog and the current CLI surface.

Quick start

# Single-shot — type your task right into the command line
wrongstack "explain what this project does"

# Or launch the interactive REPL / TUI
wrongstack
wrongstack --tui

# Run a guided demo for any example
cd examples/01-basic && bash demo.sh       # or .\demo.ps1 on Windows

Index

#	Example	What it demonstrates
01	Basic usage	Single-shot, REPL, TUI, YOLO toggle, session resume
02	Tool usage	File editing, code search, git, tests, scaffolding
03	Multi-provider	Switching providers, custom endpoints, fallback
04	MCP integration	Adding presets, stdio/SSE transports, permission control
05	Multi-agent	Director fleet, /spawn, /fleet, /steer
06	Real-world workflows	Refactor, debug, review, audit, CI scaffolding

Common flag combos

# TUI + YOLO + a fast provider (auto-approve normal project work)
wrongstack --tui --yolo --provider groq --model llama-3.3-70b-versatile \
  "add JSDoc to every exported function in src/"

# Director-mode single-shot — auto-spawns a fleet to tackle the task
wrongstack --director "audit packages/core for security issues"

# Eternal autonomy — runs sense → decide → execute → reflect until you Ctrl+C
wrongstack --eternal "keep improving test coverage in packages/core"