01 · the foreman
Sirius Forester
siriusearly alpha · v0.1.0Sirius Forester is the foreman of the Sothis suite: a local-first fleet orchestrator that claims tasks from a local issue tracker, locks the code each task touches, runs your agent, refuses to mark anything done until the affected tests pass, and files a two-way receipt linking every change to the decision behind it.
Why it exists
An agent that marks its own homework will always pass. Sirius is the supervisor loop that makes "done" mean something: the claim is atomic, the lock is real, and the gate is a test run the agent does not control.
What it does
One claim per task, one lock per symbol — parallel agents cannot silently overwrite each other.
Briefs the agent with the exact slice of code and context the task needs.
Gates completion on the tests the diff actually affects, not on the agent’s own say-so.
Files a two-way receipt: every change links to the decision behind it, and back.
Install and run
Inside Claude Code
/sirius:install-binaryPicks the tarball for your platform, verifies the checksum and the Sigstore bundle, and installs the binary.
Run the loop
$sirius runOr say "let’s get Sirius on this repo" and the plugin skill drives it.
Installing the whole suite at once is a different path —the plugins first, then every CLI in one shot.