retro-agents

Runs the agents; builds no game. Machines: old-mac-build-host. Games: the six port repos. Servers: retro-server-infra. Rules for every session: POLICY.md. Layout, window map and hooks: README.md.

# Quick reference

bin/retro-fleet.sh up [--plan plans/] start the fleet (infra/deps on demand) bin/retro-fleet.sh status | round | reload what runs; snapshot; brief drift bin/retro-fleet.sh add|stop|restart one window (stop needs a checkpoint) bin/retro-fleet.sh restart-clean [--dry-run] restart checkpointed idle sessions bin/retro-fleet.sh inbox|identity mail; cross-session name bin/retro-fleet.sh down stop them all bin/install-telemetry.sh (re)start the telemetry window bin/fleet-telemetry.sh --dry-run print the digest now bin/board.sh --active | board-add.sh | board-move.sh board 8, REST only bin/gh-budget.sh GraphQL and REST budgets, free bin/ci-status.sh red default-branch CI, all repos (REST) bin/test-scripts.sh ; bin/lint-policy.sh tests; retired-rule lint (all repos)

# Not obvious

• A brief is read once, at launch. Editing briefs/ delivers nothing until restart.
• All sessions share one account's 5000 GraphQL points an hour, charged per node touched: gh issue list/view/create/comment, gh pr, gh release list spend it. Board 8 is read and moved over REST (a separate budget).
• Fleet runners lease their canonical checkouts; a manually launched writer is outside the lease and can collide. Stage files by name.
• Telemetry (telemetry tmux window, every 5 minutes) writes /tmp/retro-fleet/digest.txt and hosts.txt; sessions write status.json via bin/hooks/status.sh. Read those, not panes. fleet-round flags a missing telemetry window.