Agent Manager & subagents
An agent can hand parts of a task to subagents that work in parallel, each with a clean context. The Agent Manager shows every chat and subagent in one place, with the actions waiting for your approval.
Subagents
When a task splits naturally (one part parses a file, another updates a menu), the agent starts subagents with the task tool:
{ "description": "Parse CSV import", "prompt": "Add a CSV parser in src/products/import-csv.ts that ...", "worktree": true }
| Field | Meaning |
|---|---|
description | a 3 to 5 word title, shown in the chat and the Agent Manager |
prompt | everything the subagent needs to know; it starts with no other context |
worktree | optional; run in its own git worktree so its edits don't touch your checkout |
- Up to 4 subagents run at once.
- Each subagent runs in Agent mode with the same model and asks for approval on its own actions.
- It ends with a short summary of what it found or changed. The lead agent reads only that summary, so its own context stays small.
- Subagents can't start subagents of their own.
- Stopping the lead chat stops its subagents too.
The lead chat shows Started 2 subagents: Parse CSV import · Export menu and one card per subagent that fills in with its result.
Worktrees
With "worktree": true, Ingot creates a git worktree on a new branch ingot/task-<name> in your temp folder. The subagent's edits stay on that branch until you merge them. Worktrees are not removed automatically; delete them with git worktree remove when you're done. With worktree tabs on, each worktree subagent also gets a tab under the title bar.
The Agent Manager
Open it with Agents: Agent Manager (⌘⌥⇧M, Ctrl+Alt+Shift+M on Windows and Linux). It opens in the bottom panel.
| Section | Shows |
|---|---|
| summary | for example 3 chats · 1 running · 1 waiting for approval |
| Waiting for approval | every pending action, oldest first, with Run and Skip right there |
| Chats and subagents | every chat, newest first, with its subagents nested under it |
Each row shows the current step (such as Editing cart.ts or 1 file to review), a worktree chip with the branch name, and a state: Running, Needs approval, Has a question, Paused, To review, Needs attention, Done or Idle. Use Stop, Artifacts (see Artifacts) or open the chat from the row.
Jump to the next approval
With several agents running, Agents: Jump to Next Agent Approval (⌘⌥⇧J, Ctrl+Alt+Shift+J) moves to the next waiting action, so you can approve them one after another without hunting through chats.
Every window and the cloud on one board
Command Center in the Agent Manager's header opens the Agent Command Center: a Kanban board with the agents of every Ingot window and your cloud agent runs, by status.