-
Notifications
You must be signed in to change notification settings - Fork 3.3k
v0.8.63: Add a first-class sub-agent on/off switch #3305
Copy link
Copy link
Open
Labels
bugSomething isn't workingSomething isn't workingdocumentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or requestreliabilityReliability, flaky behavior, retries, fallbacks, and robustnessReliability, flaky behavior, retries, fallbacks, and robustnesssubagentsSub-agent orchestration, lifecycle, and completion handlingSub-agent orchestration, lifecycle, and completion handlingtuiTerminal UI behavior, rendering, or interactionTerminal UI behavior, rendering, or interactionv0.8.63Targeting v0.8.63Targeting v0.8.63
Milestone
Metadata
Metadata
Assignees
Labels
bugSomething isn't workingSomething isn't workingdocumentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or requestreliabilityReliability, flaky behavior, retries, fallbacks, and robustnessReliability, flaky behavior, retries, fallbacks, and robustnesssubagentsSub-agent orchestration, lifecycle, and completion handlingSub-agent orchestration, lifecycle, and completion handlingtuiTerminal UI behavior, rendering, or interactionTerminal UI behavior, rendering, or interactionv0.8.63Targeting v0.8.63Targeting v0.8.63
Projects
StatusShow more project fields
In progress
Problem
Users need a clear way to turn sub-agents on or off. Today the behavior is split across feature flags, CLI disable flags, and indirect runtime limits such as
[subagents] max_depth = 0.That is too easy to miss. A user who wants "no sub-agents this session" should not have to know implementation details.
Current state / evidence
codewhale-tui --disable subagents.[subagents] max_depth = 0as blocking nested child-agent spawning.agenttool can still be visible unless the runtime/tool registry has explicitly disabled sub-agents.Proposal
Add a first-class sub-agent enabled/disabled setting with a clear runtime command.
Possible shape:
and:
The exact key name can change if it better fits the existing config model, but the user-facing behavior should be direct and discoverable.
Acceptance criteria
agenttool is hidden or fails with a concise "sub-agents are disabled" error before doing any spawn work./subagentsor status/config output clearly reports disabled state.max_depth = 0,max_concurrent = 0, feature flags, and the new enabled flag have deterministic precedence with tests.Release note target
For v0.8.63, this is a safety and control feature: users can opt out of delegation when they want a single-agent session.