View on GitHub
v1.0.0 โ€” Fresh from the Refinery

Welcome to
Fart Town

The stinkiest AI orchestration system this side of the cloud.

Like Gas Town, but way more fragrant. Orchestrate 20-30 AI agents without losing your mind (or your lunch).

CURRENT STINKINESS:73%HIGH
Welcome to Fart Town - A steampunk industrial landscape with ferrets, green gas clouds, and flatulence refineries

Live Refinery Metrics

Real-time flatulence production statistics

12 agents
Active Polecats
47 today
Convoys Landed
1,337
Molecules Processed
87%
Stinkiness Level
WARNING ยท DANGER ยท CAUTION

GET THE F*** OUT

Fart Town is not for the faint of heart (or nose). Here's why you probably shouldn't use it:

100% Vibe Coded

This entire codebase was created by AI agents orchestrated by other AI agents. I've never seen the code. Neither should you.

Stage 7+ Required

If you're not already juggling 5+ Claude Code instances daily, you will not survive in Fart Town. The superintelligent robot chimps will rip your face off.

Expensive As Hell

Fart Town is a cash guzzler. If you ever have to think about where money comes from, turn back now and shelter in place.

17 Days Old

On a scale of 'polished diamond' to 'smuggled 400 miles upriver', Fart Town is firmly in the latter category. It needs some Lysol.

Worker Roles

Fart Town workers are regular coding agents, each prompted to play one of seven well-defined worker roles. Plus you, the Overseer.

๐Ÿ‘ค

The Overseer

That's you, Human. The eighth role. You've got eye paint and an inbox. You're the boss, the head honcho, the big cheese.

๐ŸŽฉ

The Mayor

Your concierge and chief-of-staff. The main agent you talk to. Kicks off work convoys and receives notifications when they finish.

๐Ÿ˜บ

Polecats

Ephemeral per-rig workers that spin up on demand. They work in swarms to produce Merge Requests, then hand them off to the Merge Queue.

๐Ÿญ

The Refinery

Handles the Merge Queue problem. Intelligently merges all changes, one at a time, to main. No work can be lost.

๐Ÿฆ‰

The Witness

Watches over the polecats and helps them get un-stuck. Smooths out the workflow so it's almost perfect for most runs.

๐Ÿบ

The Deacon

The daemon beacon. Runs patrols in a loop and propagates DYFJ signals downward to keep Fart Town working.

๐Ÿถ

The Dogs

The Deacon's personal crew. They handle maintenance, cleanup, and occasional handyman work. Including Boot, who checks on the Deacon every 5 minutes.

๐Ÿ‘ท

The Crew

Your personal coding agents. Long-lived identities, great for design work and back-and-forth. You'll love your crew.

๐ŸฑMolecular Expression of Work

The MEOW Stack

Fart Town is the tip of a deep iceberg. The bones of Fart Town โ€” the MEOW stack โ€” may live on for years to come. It feels like more of a discovery than an invention.

LAYER 1

Beads

The atomic unit of work. A special kind of issue-tracker issue stored in JSON and tracked in Git.

LAYER 2

Epics

Beads with children. Build top-down plans with parallel or sequenced dependencies.

LAYER 3

Molecules

Chained workflows with arbitrary shapes, loops, and gates. Turing-complete and AI-executed.

LAYER 4

Protomolecules

Templates made of actual Beads. Instantiate entire workflows with variable substitutions.

LAYER 5

Formulas

TOML source format for workflows. Cooked into protomolecules, then instantiated into wisps.

LAYER 6

Guzzoline

The big sea of work molecules. All the work in the world, ready to be swarmed.

What's Better Than Gas Town?

Everything. Same powerful orchestration, but with 100% more fragrance and whimsy.

GUPP

Universal Propulsion

If there is work on your hook, YOU MUST RUN IT. The principle that keeps Fart Town moving through context windows and crashes.

Nondeterministic Idempotence

NDI Guarantee

Even though the path is fully nondeterministic, the workflow you wanted to run eventually finishes. Guaranteed.*

Merge Queue

Refinery Processing

No more monkey knife fights over rebasing. The Refinery intelligently merges changes one at a time. No work gets lost.

Town Mail

Real-time Messaging

Workers communicate through a two-level Beads structure. Rig-level work and Town-level orchestration, all tracked in Git.

Wisps

Ephemeral Orchestration

High-velocity orchestration without polluting Git. Wisps are burned after completion, optionally squashed into summaries.

Convoys

Work Order System

Every unit of slung work is wrapped in a Convoy. Track delivery of features, bug fixes, and tech debt cleanups.

Patrols

Autonomous Workflows

Refinery, Witness, and Deacon all run patrols in loops with exponential backoff. Fart Town keeps itself running.

Plugins

Extensible Attention

Coordinated or scheduled attention from an agent. Add quality gates, new UIs, and integrate with other systems.

* "Guaranteed" as long as you keep throwing agents at it. Ask your doctor if Fart Town is right for you.