$PY is the project’s pinned Python 3.11.16 interpreter inside the frozen repository. Run gbg commands from $SEGMENTS/cli. 🔒 marks commands that only the owner runs, or that an agent may run only with explicit permission in its prompt. Full details are in the CLI reference.
| Task |
Command |
| Check pins, inputs and interpreter for a config |
$PY -B -m gbg_cli preflight CONFIG |
| Compare a finished evaluation with a baseline |
$PY -B -m gbg_cli verify FINISHED_DIR --against BASELINE.json |
| Campaign status (writes an audit log entry) |
$PY -B -m gbg_cli supervise CAMPAIGN_DIR status --reason "TEXT" |
| Is the working tree clean? |
git status --porcelain (should print nothing) |
| Last commit |
git log --oneline -1 |
| Task |
Command |
| Freeze a campaign |
$PY -B -m gbg_cli campaign freeze CAMPAIGN.json --out /absolute/new/dir |
| Run or resume it |
$PY -B -m gbg_cli campaign run CAMPAIGN_DIR [--workers N] |
| Pause / resume launches |
$PY -B -m gbg_cli supervise CAMPAIGN_DIR pause --reason "TEXT" (or resume) |
| Replay every finished shard from a clean export |
$PY -B -m gbg_cli campaign replay CAMPAIGN_DIR --root EXPORT --out /absolute/new/dir --workers 4 |
| Replay a seeded sample |
$PY -B -m gbg_cli campaign replay CAMPAIGN_DIR --sample N --seed S --out /absolute/new/dir |
| Step |
Command |
| Rehearse 🔒 |
$PY -B -m gbg_cli gate rehearse CONFIG |
| Lock 🔒 |
$PY -B -m gbg_cli gate lock CONFIG |
| (owner commits) |
see the daily loop |
| Pre-run check 🔒 (S2-style gates only) |
$PY -B -m gbg_cli gate run --check-only /absolute/path/GATE.json |
| Run, exactly once 🔒 |
$PY -B -m gbg_cli gate run /absolute/path/GATE.json |
| Classify failures offline |
$PY -B -m gbg_cli gate classify GATE_DIR --out /absolute/new/dir |
The five steps, in order. Each must succeed before the next runs:
git add the paths in the agent’s COMMIT_PATHS.txt (comments, blank lines and .lock lines filtered out).- Size guard in the pinned Python: refuse if the staged total is over 20 MiB.
git commit with a descriptive message.git log --oneline -1, then git status --porcelain (must be empty).rsync -a <segments-repo>/ "<external-drive>/GameBoyGhost/Segments/" && echo BACKUP-OK
| Task |
Command (from this site’s folder) |
| Preview locally |
npm run dev |
| Build |
npm run build |
| Spell check |
npm run spell |
| Site checks (after build) |
npm run check |
Gameplay footage from The Legend of Zelda: Link’s Awakening DX, captured from the author’s own emulator runs for technical commentary. The game and its imagery are © Nintendo. This project is not affiliated with or endorsed by Nintendo. How the footage is made.