On this page
What a Manager does
A normal agent does the work itself. A Manager agent directs instead: it plans the job, starts helpers to do the parts, follows what they report, and tells you when one needs you. It never does the work itself.
- Each helper runs in its own worktree: a separate checkout of the repository on its own branch, so helpers never edit the same files.
- Helpers run on the AI tool you choose, which can differ from the Manager's own: a Claude Code Manager agent can start Codex helpers.
- Every profile has its own Manager, agents, and helpers, and never sees another profile's chats or reports.
Start one
- In Agent Mode (⌥A), on New chat, open the AI tool menu under the message box.
- Choose the AI tool for the Manager, then Manager agent.
- Under Helpers, choose the tool its helpers run on. Without a choice they run on the Manager's own tool.
- Describe the job and send it. Name the repository if you have more than one: a Manager finds the repositories you have open in Brunvo.
You can also start one from Code Mode: open the Side Panel, choose Agent, and press +. And a normal agent you ask to become a Manager agent becomes one where it works, and carries on from what it was doing.
Follow the work
- Side Panel ▸ Agent lists your agent by its own name with each helper underneath, what each is doing right now, and what it last reported. Click a helper to open it in Code Mode, on its own tab; ‹ Agents goes back to the list.
- In Code Mode's sidebar each helper sits under its repository and worktree, with a note naming the Manager it works for.
- When a helper needs your answer, it shows under Needs you and the bell counts it. Answer it in the helper's own terminal, or reply to your Manager agent, which passes your answer on.
- Helpers a Manager starts only for tests and checks run in the background: they stay out of the sidebar and leave nothing behind.
Clean up when the work is done
Once every issue a helper worked on is closed, Brunvo parks that helper (you can resume it later) and removes the worktree the Manager made for it. Worktrees you made yourself are never removed.
You can also ask any agent to park the agents that worked on something: it shows you what would close first, then parks the idle ones. It never parks itself, a Manager, or a tab you are typing in, and the Notification Center says which agent did it. When you are done for the day, ask the Manager to close itself: it finishes its reply, then its chat closes, ready to pick up again.
Settings
All of these are in Settings ▸ Agent (⌘,):
- Allow Automated Messages, per AI tool: a Manager hands work to its helpers, and helpers report back, by sending messages into their sessions. That happens only for the tools you allow here, or with setup's last step. Your own typing is never limited.
- Clean up when work is done turns the parking and worktree removal above on or off.
- Helpers at once sets how many helpers a chat's agent may run at the same time, 8 unless you change it.