wreck-it

Ralph Wiggum. Cloud Scale.

Autonomous AI agent orchestration for your codebase. Run headless in GitHub Actions or interactively via TUI — powered by the Copilot SDK.

CI & Headless Guide Read the Docs View on GitHub
🤖

Headless & CI Mode

Run without TUI for CI/CD automation. Includes a Docker-based GitHub Action for scheduled agent swarms.

☁️

Cloud Agents

Multi-model support (Copilot, Llama, GitHub Models) with optional gastown cloud runtime offloading.

GitHub Action

Drop-in GitHub Action for headless runs. Schedule agent swarms on cron, dispatch manually, or trigger from events.

🧠

LLM Task Planning

Generate structured task plans from natural-language goals. Just describe what you want and go.

🔁

Critic-Actor Reflection

Built-in critic evaluates agent output against the task before tests run, refining quality automatically.

🛠️

Adaptive Re-Planning

Consecutive failures trigger automatic task restructuring — split, rewrite, or inject prerequisites.

📦

Artefact Chaining

Pass structured outputs from one task as inputs to the next. Design docs flow into code tasks automatically.

🔍

Provenance Tracking

Full audit trail of every agent execution — model, prompts, diffs — exportable as openclaw JSON.

🎨

TUI Interface

Beautiful terminal UI showing tasks, progress, and real-time logs with pause/resume controls.

🔒

Safety & Scheduling

Max iterations, intelligent multi-factor scheduling, parallel phase execution, and git-backed reversibility.

# Add wreck-it to your GitHub Actions workflow
- uses: randymarsh77/wreck-it/action@main
  env:
    COPILOT_API_TOKEN: ${{ secrets.COPILOT_API_TOKEN }}

# Or run locally with the TUI
git clone https://github.com/randymarsh77/wreck-it.git
cd wreck-it && cargo build --release
wreck-it plan --goal "Build a REST API with auth" --output tasks.json
wreck-it run --task-file tasks.json --max-iterations 50

# Run headless for CI/CD pipelines
wreck-it run --headless --task-file tasks.json --max-iterations 100