Skip to content

Repository files navigation

slopomatic — deterministic and structured approach to slop cannoning.

slopomatic

slopomatic is a Go CLI and thin agent skill for evidence-gated loop×graph execution. Coding agents build, verify, and deliver work one auditable transition at a time — mindful token spend, without sacrificing quality.

make a plan  →  /slopomatic  →  clarify with the human  →  human releases  →  machine runs

Install

On macOS, install the signed CLI from the uinaf/tap Homebrew tap:

brew install --cask uinaf/tap/slopomatic
slopomatic version

On Linux amd64 or arm64, install the latest released binary without Go, Homebrew, jq, or sudo:

curl --proto '=https' --tlsv1.2 -fsSL \
  https://raw.githubusercontent.com/uinaf/slopomatic/main/install.sh | sh
~/.local/bin/slopomatic version

Pass --version v0.1.0 or --dest /chosen/bin after sh -s -- to pin a release or override ${HOME}/.local/bin. The installer downloads the archive and checksums.txt from the same GitHub Release, verifies the exact SHA-256, and atomically replaces the destination binary. See Release verification for the HTTPS trust boundary and independent Cosign and GitHub attestation checks.

Consumers that prefer Go tooling can instead install with Go 1.26 or newer:

go install github.com/uinaf/slopomatic/cmd/slopomatic@latest
slopomatic version

State lives in $XDG_DATA_HOME/slopomatic/slopomatic.sqlite (default ~/.local/share/slopomatic/slopomatic.sqlite). Override with SLOPOMATIC_DB.

Quick use

slopomatic init --run demo
slopomatic intake --file examples/intake.example.json --run demo
slopomatic status --json --run demo   # note intake_revision + next_action
slopomatic release --revision "$INTAKE_REVISION" --run demo
slopomatic build --run demo
slopomatic verify --cmd 'go test ./...' --run demo
slopomatic review --evidence examples/review.example.json --run demo
slopomatic deliver --evidence examples/deliver.example.json --run demo
slopomatic status --json --run demo

Default status is one compact line with next_action. Use --json for agents.

Park a human question with slopomatic ask --question "…", then slopomatic decide --answer "…". Multi-unit intake: examples/intake.multi.example.json.

Agent skill

The bundled agent skill drives the CLI. It does not contain a second runtime. Manual invocation only.

Companion tools

  • autoreview — preferred portable independent review CLI
  • On Cursor: /review-bugbot as a cheap local review option (confirm before use)

Documentation

License

MIT

About

Deterministic and structured approach to slop cannoning.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages