How to Set Up Multi-Agent Workflows: A Complete Tutorial

What is Multi-Agent Mode?

Multi-agent mode allows you to use multiple CLI AI tools (Gemini CLI, Claude Code, Codex, Qwen Code, Goose CLI, Auggie) simultaneously within AionUi's unified graphical interface. Instead of switching between terminal windows, you can access all your AI agents from one place.

Benefits:

• No terminal juggling – all agents in one GUI
• Independent sessions – each agent maintains its own context
• Local storage – all conversations saved in SQLite
• Easy comparison – test different models side-by-side

Step 1: Install Required CLI Tools

AionUi comes with Gemini CLI built-in, so you can start immediately. For other tools:

Claude Code (Claw)

# Install Claude Code
npm install -g @anthropic-ai/claw

Qwen Code

# Install Qwen Code
pip install qwen-code

See multi-agent documentation for complete installation instructions.

Step 2: Configure in AionUi

1. Open AionUi Settings
2. Navigate to Multi-Agent Configuration
3. AionUi will auto-detect installed CLI tools
4. Enable the agents you want to use
5. Configure API keys if needed

Full guide: Multi-Agent Setup

Step 3: Start Using Multiple Agents

Once configured, you can:

• Open multiple chat sessions, each with a different agent
• Compare responses from different models
• Use specialized agents for specific tasks (e.g., Claude for code review, Gemini for generation)
• Switch between agents without losing context

Best Practices

• Use Claude Code for code analysis and complex reasoning
• Use Gemini CLI for code generation and image tasks
• Use Qwen Code for multilingual tasks
• Keep sessions organized with clear naming
• Leverage local storage to review past conversations

Related Resources