Skip to content

README.md

Latest commit

 

History

History
81 lines (59 loc) · 2.64 KB

README.md

File metadata and controls

81 lines (59 loc) · 2.64 KB
Raw

ffss — the flipflopslopstack.

uinaf/ffss

ffss, the flipflopslopstack. A state machine that doesn't believe the agent, a reviewer that doesn't like the agent, and skills so the agent behaves. Ships slop; checks receipts.

CLIs

CLI What it does
slopmachine Evidence-gated implementation workflow with resumable state and forge-verified delivery
slopguard Independent second-model code review with stable terminal and JSON output

Skills

One job each.

Skill Use it for
slopmachine Running an agreed plan through build, verification, review, and delivery
slopguard Reviewing one completed change with an independent model
slopcourier Opening a change request for completed, verified work
slopnanny Monitoring a change request through review, CI, and merge
slopclean Removing AI tells from prose, code, and tests
slopspec Saving agreed work as issues, epics, or durable plans
slopscriber Auditing and updating repository documentation
slopprep Preparing repositories and runners for autonomous work
wat Rewriting rambling replies as terse status updates

Installation

CLIs

macOS, from the uinaf/tap Homebrew tap (signed):

brew install --cask uinaf/tap/slopmachine uinaf/tap/slopguard
slopmachine version
slopguard --version

Linux, or macOS without Homebrew (amd64 or arm64):

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

The installers verify release checksums and default to ~/.local/bin. Verification details: slopmachine, slopguard.

Plugin

Install the skills through the ffss Agent Plugins marketplace:

# Claude Code
/plugin marketplace add uinaf/ffss
/plugin install ffss@ffss

# Codex CLI
codex plugin marketplace add uinaf/ffss
codex plugin add ffss@ffss

# Cursor CLI (then install through /plugins)
cursor-agent plugin marketplace add https://github.com/uinaf/ffss

# Grok CLI
grok plugin install uinaf/ffss --trust

License

MIT; see LICENSE; members carry their own copies.