Skip to main content

Module layout

Module layout 

Source
Expand description

Pane-layout calculation for supervisor-mode tmux sessions.

v0.5.0 supervisor mode arranges panes as:

  • Pane 0: supervisor agent (50% width of top row)
  • Pane 1: dashboard (50% width of top row)
  • Panes 2..N+1: coding agents, row-major, up to SUPERVISOR_AGENTS_PER_ROW columns per row

Vertical proportions vary with the total number of rows. See openspec/changes/supervisor-as-pane/specs/tmux-orchestration/spec.md.

Structs§

SupervisorLayout
Computed layout parameters for a supervisor-mode tmux session.

Constants§

SUPERVISOR_AGENTS_PER_ROW
Agents per agent-grid row for v0.5.0. Hard-coded; configurable in v1.0.0.
SUPERVISOR_MAX_AGENTS
Maximum agents per supervisor session for v0.5.0. Above this, the launch is rejected with an actionable “split into multiple sessions” error. Configurable extension deferred to v1.0.0 (issue #17).
SUPERVISOR_PANE_OFFSET
Offset applied to agent-pane indices in supervisor mode: supervisor at 0, dashboard at 1, so the first coding agent lands at pane 2.

Functions§

layout_for
Pure grid-geometry function of agent count, named per the add/remove design (D1). The v0.5.0 layout builder (supervisor_layout) is already a pure function of agent_count; layout_for is the canonical name the add-branch / remove-branch specs use to make explicit that the same geometry is recomputed for N → N+1 (add) and N → N−1 (remove) re-tiling, not just the initial start-time layout.
supervisor_layout
Compute the layout for a supervisor session with agent_count coding agents.