What problem does it solve?
It ensures each spawned agent uses the most appropriate LLM model, balancing quality, cost, and task fit without requiring you to manually specify models every time.
Core Features & Use Cases
- Layered model resolution: chooses the resolved model via a first-match-wins hierarchy across persistent config, session directives, charters, task-aware automation, and a hardcoded fallback.
- Persistent preferences: supports both global (
defaultModel) and per-agent (agentModelOverrides) saved in .squad/config.json so choices survive across sessions.
- Spawn-ready acknowledgments: returns an acknowledgment that includes the resolved model alongside the spawned task for traceability.
- Task-aware auto-selection: maps common task types (e.g., code vs docs vs visual) to specific model defaults when no higher-priority layer is set.
Quick Start
Tell your coordinator to use a specific model for all future work and have it persist by saving the preference to .squad/config.json, for example: "always use claude-opus-4.6".