Skip to content

Group Chat (Beta)

Beta

Coordinate multiple AI agents in a single conversation with a moderator AI routing questions and synthesizing responses.

How Group Chat Works

Creating a Group Chat

  1. Press Alt+Ctrl+C (or Cmd+K → "New Group Chat")
  2. Select a moderator (Claude Code, OpenCode, or Codex)
  3. @mention any Maestro session in your message
  4. Agents auto-join as participants

Moderator Behavior

The moderator AI handles routing:

ScenarioModerator Action
Simple questionAnswers directly
Complex questionDelegates via @mentions to relevant agents
Incomplete responsesMakes follow-up rounds until complete
Final answer neededSynthesizes all agent perspectives

Remote Agents

Local and SSH remote agents can mix freely in Group Chat. Each works in their own environment. Remote agents show a REMOTE pill in the participant list.

Best Practices

Naming Agents

Name agents descriptively (e.g., "Frontend-React", "Backend-API", "DevOps-AWS") rather than generic names. Hyphenate names for @mentions if they contain spaces.

Good use cases:

  • Cross-project architecture questions
  • Comparative analysis across codebases
  • Coordinating changes that span multiple projects
  • Getting perspectives from agents with different specializations

See Also

Built with VitePress + RAG Chat