Runtime Documentation

Generated by fab memory-index — do not hand-edit. Descriptions come from each file's description: frontmatter.

File	Description
agent-primitives	The _cli-agents helper — opt-in agent-CLI primitives for profile-resolved spawn composition with the interactive shell fallback (; exec \"$SHELL\"), fab pane open/ready/deliver, the pane-exists/agent-state send gate (rk mux send plain / --answer / --force, rk-gated with raw-tmux fallback), printed-prompt recovery, peek via rk mux capture, artifact-oriented await (rk mux await), and a built-in-provider grammar/discovery dictionary (agy/kimi trust walls, codex mcp-server).
dispatch	fab dispatch {start,open,ready,deliver,restart,status,wait,logs,kill,reap,clean} manages headless and pane stage workers: pane open/ready/deliver (including resume), headless start, preference-bounded pane → native → headless descent, valid user providers that omit interactive grammar, identity-checked pane liveness (the pane_pid restart-alias discriminator), state layout, observation, recovery, placement, and reaping.
operator	Operator coordination skill (/fab-operator) — multi-repo/multi-session coordination on one tmux server via the (session, repo, pane) addressing tuple and a server-keyed state file mutated by fab operator subcommands: the binary-owned tick diff (tick-start --diff --quiet, incl. agent_exited), the fab pane questions auto-answer sweep, adaptive agent-state heartbeat, repo/session-targeted spawning, dependency resolution, repo-spanning autopilot, and the shell-fallback launcher.
pane-commands	fab pane {map,capture,process,window-name,open,ready,deliver,kill,questions} reference: map delegates enumeration to rk mux panes, enriches with change/stage, and declares the identity-key contract (pane+server/window_id identity; session/window_index display-only); open spawn + ready/deliver primitives, --server/-L, exit codes 2/3. capture/process/kill are dispatch-internal (skill-facing rides rk mux twins); questions: the skill-facing exception (policy-bearing sweep).
providers-and-profiles	Provider mechanics and role policy — session/workers depth knobs, environment and launch overrides, four pane-capable built-ins with independent interactive/native/headless grammar and per-role fills, six roles, precedence, stage mapping, fab agent YAML resolution, deprecated fab resolve-agent compatibility, dispatch-mode descent, and consumers.
runtime-agents	Agent-state divestment: fab reads the @rk_pane_agent_state tmux pane option (state:epoch_seconds[:pid]; active/waiting/idle, absent = unknown; legacy @rk_agent_state read as a fallback during run-kit's deprecation window) via plain tmux — a data convention, NOT a run-kit software dependency; run-kit's rk agent setup is the writer. The former .fab-runtime.yaml _agents producer pipeline is deleted; fab is a pure consumer via the pure parseAgentState parser + FormatIdleDuration.