Operator

August 7, 2026 · View on GitHub

The operator (/fab-operator) is a long-running coordination layer that sits in its own tmux pane, observing and directing agents across other panes.

CommandPurpose
/fab-operatorMulti-agent coordination — monitoring, auto-answering, autopilot queues, dependency-aware spawning

Version History

The current operator (v9) evolved through nine iterations:

VersionKey addition
v1Observe and interact with agents across tmux panes
v2Proactive monitoring after every action
v3Auto-nudge for agents waiting on user input
v4/loop-driven monitoring, auto-nudge answer model, playbook catalog
v5Use case registry (Linear inbox, PR freshness), branch fallback, autopilot queues
v6Clean rewrite — principles-driven inference, persistent operator state on disk (a repo-rooted .fab-operator.yaml at the time; the state file is now server-keyed at $XDG_STATE_HOME/fab/operator/<server-slug>.yaml), generic watches, framed status output
v7Dependency-aware agent spawning (cherry-pick chains), branch map persistence, bounded retries, pre-send validation tiers
v8Pipeline-first routing, unified tick status frame, stack-then-review autopilot (with ordered merge), »<wt> tab naming, mandatory auto-enroll, /fab-proceed integration
v9Spawn-in-worktree principle — operator pane reserved for coordination state; all pipeline work runs in freshly spawned agent tabs, never in the operator pane itself