loom-team-manager-pane-dead-on-spawn

name: loom-team-manager-pane-dead-on-spawn description: Diagnose and fix Loom team manager pane dying immediately (tmux pane status 1). license: MIT compatibility: opencode,claude metadata: created_at: "2026-01-29T09:27:53.279Z" updated_at: "2026-01-29T09:27:53.279Z" version: "1"

When To Use

• loom team start <TEAM> succeeds, but manager pane shows dead (status 1) and capture output is empty.

Diagnose

• Confirm run exists:
  • loom team status <TEAM> --show-dead
• Capture manager:
  • loom team capture <TEAM> manager --lines 200 --header
• Open the capture metadata file under .team/runs/<TEAM>/captures/*.json and check:
  • pane.start_command
  • pane.current_command
  • pane.dead

Common Root Cause: Missing team Binary

• If pane.start_command begins with team tui ...:
  • Verify: command -v team (likely missing)
  • Verify Loom exists: command -v loom
  • This means the pane died because tmux tried to run team directly.

Fix Options

• Option A (fast local): add a team shim on PATH that forwards to Loom.
  • team should behave like: loom team "$@"
• Option B (proper): adjust Loom/runner config so tmux spawns loom team tui ... (not team tui ...).
• Option C: pass an explicit harness --bin that points to the correct executable if supported.

Validate

• Restart run (or use --force):
  • loom team start <TEAM> --force ...
• Confirm manager pane is alive:
  • loom team status <TEAM>
  • loom team capture <TEAM> manager --lines 40

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.