Skip to main content
The TUI supports running multiple agents in the same conversation, each with its own provider, model, and system prompt.

Creating Agents

Open the Agent Manager from the command palette (Ctrl+P) to add, remove, or configure agents. Each agent gets:
  • A unique name and color label
  • Its own provider and model
  • An independent session on the server

Mentions

Use @AgentName in your message to direct it to a specific agent:
@Claude explain this function
@Codex refactor the test file

Relay Policies

Control how messages are shared between agents:
PolicyBehavior
MentionsOnlyAgents only see messages addressed to them (default)
BroadcastAllAll agents see all messages

Threads

Create coordinated multi-agent threads with:
  • A shared goal
  • Selected participants
  • A configurable number of iterations
Agents take turns responding to achieve the goal collaboratively.

Handoff

Switch a conversation to a different model mid-chat:
ModeDescription
SummaryGenerates a summary of the conversation for the new model
FreshStarts the new model with no prior context

Compaction

When a conversation exceeds 75% of the context window, the TUI automatically compacts it by summarizing earlier messages to free up space.