ACP Setup

🤖 AionUi Multi-Agent Mode Configuration Tutorial

This tutorial will detail how to configure and use Multi-Agent Mode in AionUi, including integration with external CLI tools like Claude Code, Qwen Code, CodeX, iFlow CLI, etc. These external tools are integrated through ACP (Agent Communication Protocol) for unified interface management.

English | 简体中文

🎯 Multi-Agent Mode Overview

Multi-Agent Mode is one of AionUi's core features, making AionUi a free and open source Claude Cowork alternative with multi-agent collaboration capabilities. It allows you to use different AI agents in a unified interface. These external CLI tools are integrated through ACP (Agent Communication Protocol) with the following characteristics:

• Unified Interface Management: All agents operate in the same interface - no more command line needed
• Automated Task Execution: AI agents can independently execute tasks, run scripts, read/write files, and operate tools automatically
• Workflow Automation: Complete workflow automation capabilities similar to Claude Cowork, with file system operations and task completion
• Independent Functionality: Each agent maintains its original features and capabilities
• Protocol Standardization: Standardized communication through ACP protocol
• Flexible Extension: Supports integration of more CLI tools that comply with ACP protocol

Supported External Agents

Agent	CLI Command	Status
Claude Code	claude	✅ Supported
Qwen Code	qwen	✅ Supported
CodeX	codex	✅ Supported
iFlow CLI	iflow	✅ Supported
Goose	goose	✅ Supported
Augment Code	auggie	✅ Supported
Kimi CLI	kimi	✅ Supported
OpenCode	opencode	✅ Supported
Factory Droid	droid	✅ Supported
CodeBuddy	codebuddy	✅ Supported
GitHub Copilot	copilot	✅ Supported
Qoder CLI	qodercli	✅ Supported
Mistral Vibe	vibe-acp	✅ Supported
Nano Bot	nanobot	✅ Supported
OpenClaw	openclaw	✅ Supported
Gemini CLI	Built into AionUi	✅ Enabled by default

💡 Tip: AionUi also supports Custom Agents, allowing you to configure any CLI tool that complies with the ACP protocol in the settings.

Multi-Agent Mode vs Gemini CLI Mode

Feature	Gemini CLI Mode	Multi-Agent Mode
Installation Requirements	Built into AionUi, users get it by default after downloading	Requires users to download and install themselves, then AionUi recognizes and integrates
Technical Architecture	AionUi built-in Agent, based on Google Gemini CLI	External CLI tools integrated via ACP protocol
Feature Completeness	Complete features (image generation, tool scheduling, multi-API key rotation, etc.)	Currently relatively simple, mainly GUI management of conversations and workspaces
Configuration Integration	Direct access to all AionUi configuration features	Currently cannot directly use AionUi's LLM configuration, image generation, and other built-in features
Future Development	Most complete functionality, continuous optimization	ACP-integrated tools will gradually catch up, unified management features planned
Use Cases	Daily use, complete AI functionality experience	Professional users, specific CLI tool requirements

---

🚀 Step 1: Install CLI Tools

Before configuring Multi-Agent Mode, you need to install the corresponding CLI tools first.

Claude Code Installation

1. Install Claude CLI

   # Install globally with npm
   npm install -g @anthropic-ai/claude-code

2. Verify Installation

   claude --version

3. Authentication Configuration

   # Login to Claude account
   claude login

📖 Official Documentation: Claude Code GitHub

Qwen Code Installation

1. Install Qwen CLI

   # Install globally with npm
   npm install -g @qwen-code/qwen-code

2. Verify Installation

   qwen --version

3. Authentication Configuration

   # Login to Qwen account
   qwen login

📖 Official Documentation: Qwen Code GitHub

CodeX Installation

1. Install CodeX CLI

   # Install globally with npm
   npm install -g @openai/codex

2. Verify Installation

   # Check version
   codex --version

3. Authentication Configuration

   # Login to OpenAI account
   codex login

📖 Official Documentation: OpenAI Codex CLI

iFlow CLI Installation

1. Install iFlow CLI

   # Install globally with npm
   npm install -g @iflow-ai/iflow-cli

2. Verify Installation

   iflow --version

3. Authentication Configuration

   # Login to iFlow account
   iflow login

📖 Official Documentation: iFlow CLI GitHub

Goose Installation

1. Install Goose CLI

   # macOS using Homebrew
   brew install block/tap/goose
   
   # Or using pipx
   pipx install goose-ai

2. Verify Installation

   goose --version

3. ACP Mode

   # Goose uses subcommand for ACP
   goose acp

📖 Official Documentation: Goose GitHub

Augment Code Installation

1. Install Augment Code CLI

   # Install globally with npm
   npm install -g @anthropic-ai/augment-code

2. Verify Installation

   auggie --version

3. ACP Mode

   # Auggie uses --acp flag
   auggie --acp

📖 Official Documentation: Augment Code

Kimi CLI Installation

1. Install Kimi CLI

   # Install globally with npm
   npm install -g @anthropic-ai/kimi-cli

2. Verify Installation

   kimi --version

3. ACP Mode

   # Kimi uses --acp flag
   kimi --acp

📖 Official Documentation: Kimi CLI (Moonshot)

OpenCode Installation

1. Install OpenCode CLI

   # Install with Go
   go install github.com/opencode-ai/opencode@latest

2. Verify Installation

   opencode --version

3. ACP Mode

   # OpenCode uses subcommand for ACP
   opencode acp

📖 Official Documentation: OpenCode GitHub

Factory Droid Installation

1. Install Factory Droid CLI

   # Refer to Factory official documentation for installation
   # Requires FACTORY_API_KEY environment variable

2. Verify Installation

   droid --version

3. ACP Mode

   # Droid uses special exec command format
   droid exec --output-format acp

📖 Official Documentation: Factory Droid

---

💬 Step 2: Using Multi-Agent Mode

Create Multi-Agent Conversation

1. Select Agent

   • Choose the external agent to use on the welcome interface
   • System will display detected available agents (integrated via ACP protocol)

2. Create Conversation

   • Enter message content
   • Select working directory (optional)
   • Click send to start conversation

Conversation Features

1. Real-time Connection Status

   • Shows agent connection status
   • Automatic reconnection mechanism
   • Connection error prompts

2. Permission Management

   • CLI tools will request file operation permissions
   • Confirm or deny permission requests in AionUi
   • Supports one-time or permanent authorization

3. Tool Calling

   • Supports CLI tool's native functionality
   • File read/write operations
   • Code execution and debugging

---

❓ Common Questions

Q: What's the difference between Multi-Agent Mode and Gemini CLI mode?

A: Main differences:

• Gemini CLI Mode: AionUi's built-in core functionality, users get it by default after downloading, supports image generation, tool scheduling and other complete features
• Multi-Agent Mode: Requires users to install external CLI tools themselves, AionUi recognizes and integrates them through ACP protocol, currently relatively simple functionality, will develop MCP settings functionality to enhance integration in the future

Q: When to choose Multi-Agent Mode?

A: Selection recommendations:

• Daily Use: Recommend Gemini CLI mode, most complete functionality, ready to use out of the box
• Professional Needs: If you need specific CLI tool functionality (like Claude Code, Qwen Code, etc.), you can choose Multi-Agent Mode
• Future Planning: MCP functionality will let Multi-Agent Mode enjoy more unified features

Q: How to know if Multi-Agent Mode is working properly?

A: Check methods:

• Can see agent options on welcome interface
• Can connect normally when creating conversations
• Can receive replies when sending messages
• Permission requests display normally

Q: What features does Multi-Agent Mode support?

A: Current features:

• Basic conversation functionality
• File operation permission management
• CLI tool's native functionality
• Working directory management

---

🔧 Troubleshooting

Q: Multi-Agent Mode not detected?

A: Check steps:

1. Confirm CLI tool is properly installed

   # macOS/Linux
   which claude
   which qwen
   which iflow
   which goose
   which auggie
   which kimi
   which opencode
   which droid
   
   # Windows
   where claude
   where qwen
   where iflow
   where goose
   where auggie
   where kimi
   where opencode
   where droid

2. Verify CLI is in system PATH

   • Ensure CLI tools are in system environment variable PATH
   • Restart terminal or command line window

3. Check CLI tool version

   claude --version
   qwen --version
   iflow --version
   goose --version
   auggie --version
   kimi --version
   opencode --version
   droid --version

4. Restart AionUi to re-detect

   • AionUi automatically scans system PATH on startup
   • Detects installed external CLI tools
   • Shows available Multi-Agent options on welcome interface

Q: Authentication failed?

A: Solutions:

1. Run claude login or qwen login in terminal
2. Complete CLI tool authentication process
3. Restart AionUi to reconnect

Q: Connection timeout?

A: Possible reasons:

1. Network connection issues
2. CLI tool service unavailable
3. Firewall blocking connection
4. CLI tool version too old

Q: Permission requests not showing?

A: Check configuration:

1. Confirm Multi-Agent Mode is properly connected
2. Check AionUi permission settings
3. Restart conversation to re-establish connection

---

📚 Related Documentation

• Quick Start: Getting Started
• LLM Configuration: LLM Configuration
• Image Generation Configuration: Image Generation Setup
• Common Questions: FAQ

---

Need Help?

• 🐛 Report Issues
• 💬 Community Discussions
• 📖 Complete Documentation

Multi-Agent Mode lets you enjoy the powerful functionality of multiple AI tools in AionUi!