Spec-driven agentic development: one versioned spec per repo, stored as one file or a capability bundle and applied by any agent CLI.

respex manages the lifecycle of a design spec and dispatches any agentic CLI (Claude Code, Gemini CLI, Codex, aider, opencode, amp, …) to act on it:

init → view/edit → refine → diff → commit → apply → verify

The spec is the durable source of truth; the codebase converges to it. ReSpex coordinates commits, agent runs, history, and rollback so changes are reviewable and recoverable.

Install

GitHub Releases

Download the binary for your operating system and architecture from GitHub Releases, then place it on your PATH.

Prebuilt binaries are available for Linux, macOS, and Windows on amd64 and arm64.

Build from source

Clone the repository and run:

go build .

Quick start

respex init "a CLI that converts CSV to JSON"
respex view
respex edit
respex refine
respex diff --refine latest
respex diff
respex commit -m "initial spec"
respex apply
respex apply          # → "nothing to do (v1 already applied)"

Next steps

• Getting started — initialize, baseline, and iterate.
• End-to-end process — the complete lifecycle and when to use each command.
• Writing specs — how to write a prescriptive spec instead of a bug tracker.
• Open Questions workflow — resolving decisions before applying.
• Configuration — user and project settings.
• Verification — opt-in conformance checks that keep applies honest.
• Commands — full command reference.
• Workflows — refine, baseline, apply, and rollback patterns.
• Multi-file specs — capability bundles and automatic baseline selection.