Last updated: 2026-09-27

🎼 Orchestrator Mode Is Deprecated — Kilo Code Subagents

Orchestrator mode is deprecated and scheduled for removal. Kilo's Code, Plan and Debug agents can now split work into subagents on their own, so you no longer switch into a separate orchestrator before a big task. Pick the agent that fits the job, and it delegates when delegation helps.

This page was rewritten on 2026-09-27

This page used to present Orchestrator mode, with its planner, coder and debugger split, as Kilo's headline feature. Kilo's docs now mark it deprecated. Everything below is checked against Kilo's own documentation.

What to do instead

  • Code for implementation, Plan for architecture, Debug for troubleshooting. Each launches subagents when a subtask benefits from its own context.
  • Stop switching to Orchestrator before complex tasks; the agent you're in already has the capability.
  • For specialised delegation, define custom subagents (see Kilo's Custom Subagents docs) or custom agents with their own prompt, model and permissions.

How subagents work

  1. The agent decides a subtask would benefit from isolation, such as exploring a codebase, a parallel search, or a side task.
  2. It starts a subagent with the task tool, for example general for autonomous work or explore for research.
  3. The subagent has its own conversation history but works in the same project directory or worktree, so it doesn't isolate file edits.
  4. Foreground tasks return before the parent continues. Background tasks let the parent carry on and deliver their results later. Several can run at once.

Kilo Swarm (on by default) lets a session and its subagents share findings on a common board. It works with any agent and doesn't need Orchestrator mode.

Controlling cost and model choice

  • subagent_model in kilo.jsonc (or Settings → Models) sets a default model for subagents. If unset, they inherit the parent's model, so an expensive main model means expensive subagents.
  • For real isolation of file changes, run parallel work in separate git worktrees (Agent Manager in VS Code, the Agents view in JetBrains) rather than relying on subagents.
  • Auto Efficient is another way to keep routine subtasks on cheaper models.

Sources: Kilo Code documentation, kilo.ai/pricing and Kilo-Org/kilocode releases (v7.8.1, 2026-09-25). Checked 2026-09-27.

← Back to the Kilo Code hub

📬 Weekly Digest — In Your Inbox

One email a week: top news, releases, and our deepest new guide. No spam. Same content via RSS if you prefer.