rauf

Rauf

Autonomous coding loops, managed.

Rauf installs, manages, and monitors AI coding loops across your local projects. Define a backlog, start the loop, and let Claude Code ship work items autonomously — with full visibility through a CLI and web dashboard.

Self-hosted from day one. Rauf built itself — every backlog item in this repo was implemented, verified, and committed by its own loop. The screenshots below are rauf managing rauf.

---

How It Works

1. Backlog — You define work items with titles, priorities, and acceptance criteria
2. Pick — The loop runner selects the next pending item by priority (dependency-aware)
3. Claude Code — A fresh Claude Code session reads the item, implements changes, and runs verification
4. Verify & Commit — If all criteria pass, changes are committed and the loop advances

Each iteration produces one of three exit signals:

Signal	Meaning	What happens
RAUF_DONE	All acceptance criteria passed	Item marked done, loop continues
RAUF_BLOCKED	Missing dependency or unclear spec	Item paused, loop retries or skips
RAUF_NEEDS_HUMAN	Requires a decision or API key	Loop pauses for human input

---

Features

• Auto-detect & install — Detects Node.js, Python, Go, Rust stacks and deploys loop artifacts in one command
• Greenfield init — Scaffold a new project with git, CLAUDE.md, backlog, and loop infrastructure
• Structured backlog — JSON-based task queue with priorities, types, acceptance criteria, and dependencies
• Real-time status — Loop state derived directly from state.json with log-parsing fallback
• Web dashboard — React SPA with project cards, backlog management, live log streaming via SSE
• Full CLI — Every dashboard action available headless for scripting and CI
• Single binary — Compiles to one executable via bun build --compile (CLI + server + frontend + templates)
• Self-contained projects — Installed projects work standalone, no rauf manager required

---

Multi-agent / feature-forge

Rauf is the default loop runner for feature-forge, an agent-agnostic spec-and-backlog pipeline that runs on Claude, Codex, Copilot, Cursor, and Gemini. feature-forge hands its generated backlog to a conforming runner; when no runner is configured it defaults to rauf. See feature-forge's README for the cross-agent install story and its per-agent setup docs.

---

Install

Prerequisites: Claude Code CLI and Git (rauf spawns a Claude Code session each iteration and commits the result). Building from source also needs Bun 1.0+, pnpm 9+, and Node.js ≥ 22.

From source (recommended)

Building from source gives you the current version and is the supported path today:

git clone https://github.com/garygentry/rauf.git
cd rauf
pnpm install && pnpm build
bash scripts/install-global.sh   # symlinks `rauf` into ~/.local/bin
rauf version                     # verify (~/.local/bin must be on your PATH)

Prebuilt binary (optional)

Each tagged release also publishes self-contained binaries (no Bun/Node on the target machine), verified against the release's SHA256SUMS. This installs the latest published release, which may lag the source tree:

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/garygentry/rauf/main/scripts/install-binary.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/garygentry/rauf/main/scripts/install-binary.ps1 | iex

Set RAUF_VERSION=<tag> to pin a specific release instead of latest. macOS binaries are unsigned; if Gatekeeper blocks one downloaded via a browser, run xattr -d com.apple.quarantine ./rauf. See Releasing & Installing for details.

---

Quick Start

Once rauf is on your PATH (see Install above):

# Install rauf into an existing project
rauf install ~/workspace/my-project --yes

# Add a work item
rauf backlog add ~/workspace/my-project \
  --title "Add user authentication" \
  --type feature --priority 1 \
  --ac "Login endpoint returns JWT" \
  --ac "pnpm test passes"

# Start the loop
rauf loop run ~/workspace/my-project