← The ShowroomAgent infrastructure

Writeup only

BTF4E Agent Toolkit

Formerly Flywheel

Scripts for running several AI coding agents on one project without them stepping on each other.

Status
Working
Built with
Bash, git, NATS messaging, cron
Last worked on
2026-10

What it is

The BTF4E Agent Toolkit is the set of scripts and notes we use to run several AI coding agents at once. Each agent gets its own name and identity, posts what it's doing to a shared message channel, and works on its own branch. Helper scripts show a dashboard of who is doing what, predict merge conflicts before they happen, and launch or coordinate agents one after another or in parallel. A roadmap file lists the work agents can pick up. It also includes Flywheel, an earlier experiment in which scheduled agents read a folder of project notes each day, wrote a morning plan, pushed a few tasks forward and checked in every few hours. Flywheel ran from March to September 2026 and has since been retired in favor of a simpler ticket system.

How it works

  1. Give each agent an identity and start the message broker.
  2. Launch agents, one at a time or several in parallel.
  3. Agents announce their work; you watch the status dashboard and message log.
  4. Before merging, run the conflict predictor to spot overlapping changes.
  5. Clean up stale branches when a phase is done.

What exists today

What isn't there yet

Under the hood