@-mention agents
This guide shows you how to @-mention agents.
How @-mentions work
Section titled “How @-mentions work”When you type @agent-name in a message, Control Center:
- Parses the mention tokens from the message text
- Resolves each mention to a unique agent in the workspace
- Injects the mention context (who mentioned whom, the channel roster) into the dispatched agent’s prompt
Mentioned agents are dispatched with the conversation context.
Mention syntax
Section titled “Mention syntax”@alice fix the login bugThe mention is the @ symbol followed by the agent’s name (case-insensitive). The agent name must match exactly.
Mention multiple agents
Section titled “Mention multiple agents”@alice refactor the auth module. @bob write tests for it.Both agents dispatch in parallel, each receiving the full message as context plus their own isolated worktree.
Mention in a group channel
Section titled “Mention in a group channel”In a group channel, all participants can see the message. Mentioned agents respond; unmentioned agents observe but don’t dispatch.
Resolution
Section titled “Resolution”The MentionResolver resolves @-mention tokens:
- Exact match on agent name (case-insensitive)
- If ambiguous, resolves to the top-level agent (not one buried in the hierarchy)
- Unresolved mentions are left as plain text
The AgentLoopGuard prevents infinite dispatch loops:
- Self-trigger guard: an agent can’t dispatch itself via mention
- Recent-participant guard: suppresses re-dispatch if the agent already participated recently
Mention context
Section titled “Mention context”When an agent is dispatched via mention, it receives MentionContext:
- Who mentioned it (user or another agent)
- The full channel roster (who else is in the conversation)
- The message that triggered the dispatch
This context helps the agent understand its role in the conversation.