Multi-Agent Mode
Use multiple CLI AI tools in one unified graphical interface. AionUi auto-detects local tools and provides one GUI. See Wiki: ACP Setup for step-by-step setup.
Supported CLI Tools
AionUi can integrate with:
- Gemini CLI – Built-in; no extra install needed
- Claude Code (Claw)
- Codex
- OpenCode
- Qwen Code
- Goose CLI / Goose AI
- Auggie / Augment Code
Benefits
- Auto detection – Recognizes installed CLI tools
- Unified interface – One GUI instead of multiple terminals
- Local storage + multi-session – Conversations saved locally; multiple parallel sessions with independent context
Typical setup flow
- Install the CLI tools you need (Gemini CLI is bundled with AionUi; others ship separately).
- Authenticate each tool the way its vendor expects—API keys,
claude login, or local config files. - Open AionUi settings, confirm detection, and name sessions so you can tell “Codex refactor” from “Gemini research” at a glance.
- Optional: add MCP servers shared across agents for databases or internal APIs.
Walkthrough: Multi-agent setup guide.
When to use multiple agents
- Different strengths – One model for codegen, another for long-form reasoning or cheaper triage.
- Isolation – Keep client A’s context out of client B’s chat tree.
- Migration – Compare answers from a new CLI release without losing your old workflow.
Troubleshooting
- Tool not detected – Ensure the binary is on the PATH seen by GUI apps (macOS LaunchAgents often differ from Terminal).
- Auth errors – Re-run the vendor’s login command; tokens expire independently of AionUi.
- Version skew – Upgrade both the CLI and AionUi when release notes mention protocol changes.