Background
PR #209 adds per-call spawn_mode = visible | headless | auto for swarm-created agents so callers can avoid focus-stealing headed terminals.
Follow-up
Add a user/global config default so users can prefer headless swarm workers without specifying spawn_mode on every call.
Possible shape:
[agents]
swarm_spawn_mode = "headless" # visible | headless | auto
Explicit tool-call spawn_mode should override the config default.
Acceptance criteria
- Config parses and validates
visible, headless, and auto.
- Omitted tool
spawn_mode uses the config default.
- Existing behavior remains unchanged when no config is set.
- Tests cover defaulting and explicit override.
Background
PR #209 adds per-call
spawn_mode = visible | headless | autofor swarm-created agents so callers can avoid focus-stealing headed terminals.Follow-up
Add a user/global config default so users can prefer headless swarm workers without specifying
spawn_modeon every call.Possible shape:
Explicit tool-call
spawn_modeshould override the config default.Acceptance criteria
visible,headless, andauto.spawn_modeuses the config default.