Project - Loopexec
Bounded execution CLI for running deterministic work loops against SMALL-governed repositories with explicit checkpoints and validation.
- Status
- released
- Year
- 2026
- Type
- Internal system
Overview
Loopexec is the bounded execution runtime companion to SMALL Protocol. SMALL defines the durable work state: intent, constraints, plan, progress, and handoff. Loopexec focuses on the execution side: one explicit loop, one machine-readable outcome, and clear signals for automation that needs to know whether work succeeded, halted, or failed.
The released CLI is intentionally narrow. It locks down command names, JSON output shape, and exit-code behavior so other tools can integrate against a stable contract while the deeper SMALL-driven loop engine continues to develop behind that surface.
This makes Loopexec useful as a real integration boundary now: it can initialize loop state, run deterministic command surfaces, report status, check workspace health, and emit exactly one JSON object when automation needs a parseable result.
What ships
- Go CLI shipped from cmd/loopexec
- Implemented commands: init, run, status, check, and step
- Global --json mode for deterministic machine-readable output
- Explicit exit-code contract for success, halted states, invariant failures, workspace errors, execution failures, and internal errors
- Contract tests for JSON output plus CI gates for gofmt, go vet, and go test
- Public docs covering current CLI behavior, integration guidance, target architecture, and loop contract
Install
$ go install github.com/justyn-clark/loopexec/cmd/loopexec@latestFocus areas
- execution
- cli
- automation