AI Agent CLI Installation
This page is the unified local AI Agent CLI installation entry in repos/docs. HagiCode currently supports 11 active Agent CLIs, following the backend PrimaryProfessions order: Claude Code, Codex, GitHub Copilot, OpenCode, Hermes, QoderCLI, Kiro, Kimi, Gemini, DeepAgents, and Codebuddy.
How to use this page
Check the table for the current support state and setup mode first, then continue with the vendor-maintained installation, authentication, ACP, permission, and troubleshooting docs. Support scope and setup mode are separate concerns.
Current support matrix
| Tool | Current state | Setup mode | Official install entry | Official reference entry | Notes |
|---|---|---|---|---|---|
| Claude Code | Currently supported | One-click install | Getting Started | Overview | Default guided install path. |
| Codex | Currently supported | One-click install | OpenAI Codex CLI repository | OpenAI Codex docs | Default guided install path. |
| GitHub Copilot | Currently supported | One-click install | Install Copilot CLI | Copilot CLI overview | Default guided install path. |
| OpenCode | Currently supported | One-click install | OpenCode CLI docs | OpenCode docs | Usually needs a login or /connect step after installation. |
| Hermes | Currently supported | Manual installation / authentication | Hermes installation | Hermes quickstart | Supported now, but the local install and auth steps stay manual. |
| QoderCLI | Currently supported | One-click install | Qoder Quick Start | Qoder ACP | Finish the vendor login flow after install. |
| Kiro | Currently supported | One-click install | Kiro Installation | Kiro Authentication, Kiro ACP | The official installer opens the first-run auth flow. |
| Kimi | Currently supported | One-click install | Kimi Getting Started | Kimi ACP Reference | Finish the vendor login flow after install. |
| Gemini | Currently supported | Manual installation / authentication | Gemini CLI installation, execution, and releases | Gemini CLI authentication setup | Supported now, but you install and authenticate the local CLI yourself. |
| DeepAgents | Currently supported | Manual installation / authentication | DeepAgents CLI overview | DeepAgents ACP | Supported now, but you need a working local deepagents --acp first. |
| Codebuddy | Currently supported | One-click install | CodeBuddy CLI Installation | CodeBuddy ACP | Default guided install path. |
State glossary
- Currently supported means the CLI belongs to the current active HagiCode support range.
- One-click install means HagiCode provides a guided installation entry point; some CLIs still require a vendor login or auth step after installation.
- Manual installation / authentication means the CLI is supported now, but you must finish the local install or auth flow before HagiCode can detect and use it.
- Legacy compatibility only means a retired value such as
IFlowClistill exists for historical data compatibility, but it is not part of the current active support range.
Recommended next steps
- Continue with Install Node.js and Install OpenSpec if you still need prerequisites.
- If you want one local gateway for multiple OpenAI-compatible tools, continue with OmniRoute Installation and Usage.
- Return to the Installation Guide for the broader setup path.
- If you arrived here from a historical blog post, treat this page and the installation overview as the current evergreen source of truth.