ChaseSunstrom/sampo

formerly Foreman
The discipline layer for coding agents.
Claude Code, Codex, Gemini CLI, opencode, or its own sampo smith on any model.
It plans before it edits, proves its work with commands it really ran, keeps to one task at a time
and works through the queue, while a Ward stops the commands you'd never want run in bypass mode.
Install ·
How it works ·
The Ward ·
Features ·
Any model ·
Docs ·
Site
A real session in a copy of this repo: one typed request, then about two minutes of Claude working through Sampo (sped up while the model thinks). Its fix is in Sampo now (T-1213). MP4
## Why
Coding agents are fast. Left alone, they also edit before they understand, say "tests pass" without running them, chase new ideas mid-task, lose their place after a compaction, and in bypass mode will run the one command you'd never type.
Sampo is the mill that produces by itself, on every job site, whichever agent works it: Claude Code, Codex, Gemini CLI, opencode, or sampo smith on a model of your choice.
| Sampo | So that |
| Plans first | Every request becomes a brief before any edit: type, size, what "done" means and the command that proves it. No task, no edit. |
| Proves it | Evidence is a command sampo ran and recorded, never a sentence. A fix needs a test that failed first. Nothing closes without its audits. |
| Guards bypass mode | A fail-closed Ward stops wide deletes, force-pushes, credential reads and curl \| sh, and saves uncommitted work before git throws it away. |
| Stays on task | One active task. New ideas go to the inbox instead of being chased; NOW: switches on purpose. |
| Never loses its place | State lives on disk, so after /compact or in a new session Claude resumes at the exact step. A revert reopens the step it undid. |
| Keeps going | Drive mode works the whole queue, then finds its own next work. sampo run and sampo serve keep it going headless. |
| Learns | Your corrections and Sampo's own friction become lessons, tripwires and fixes. |
The names
The names. They come from the Kalevala. Ilmarinen the smith forged the Sampo, the mill that makes by itself: that is Smith, the task loop that plans, builds and proves. Väinämöinen sang runes that made things: Rune, the tower that writes itself toward a goal. Louhi set impossible tasks: Louhi, the exam. The stolen sun and moon were forged anew: Moons, the ideas worth forging. Lost words were fetched back from the underworld: Underworld, the not-yet ledger. And the Ward guards.
## How it works
Every request, however terse, goes round the same loop:
Understand. Intake turns your words into a brief: its type, its size (S, M or L), what done means with the command that proves it, and the steps.
Build. Edits wait for the brief, and every command passes the Ward.
Prove. A task closes only with fresh evidence and its audits.
Learn. Lessons and decisions are recorded, then the next queued task starts by itself.
## Quick start
bash
curl -fsSL https://raw.githubusercontent.com/ChaseSunstrom/sampo/main/install.sh | bash
Or from inside Claude Code:
/plugin marketplace add ChaseSunstrom/sampo
/plugin install foreman@foreman
| Then | How |
| Ask for something | fix the login timeout on slow wifi, in plain words. That's the whole interface. |