AI Agent CLI Installation

This page is HagiCode’s unified local AI Agent CLI installation entry. HagiCode currently supports 16 active Agent CLIs: Claude Code, Codex, GitHub Copilot, OpenCode, Hermes, QoderCLI, Kiro, Kimi, Gemini, DeepAgents, Codebuddy, Reasonix, Pi, OMP, Junie, and DSH.

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.

Prepare Node.js 24+ First

Most CLIs that support one-click installation depend on Node.js and npm, and Desktop also uses the node and npm on your system (Desktop no longer bundles Node.js). Please prepare version 24 or higher by following Installing Node.js first, and finish signing in or authenticating after installation: the Initialization Wizard only lists CLIs it has detected locally.

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.
Reasonix	Currently supported	Manual installation / authentication	Reasonix GitHub repository	Reasonix website	Supported now, but install the reasonix CLI and finish its authentication first; ACP mode runs through reasonix acp.
Pi	Currently supported	Manual installation / authentication	Pi GitHub repository	Pi GitHub repository	Supported now; the upstream npm package requires Node.js 22.19.0 or later.
OMP	Currently supported	Manual installation / authentication	Oh My Pi installer	Oh My Pi GitHub repository	Supported now; after installing, confirm the executable with omp --version.
Junie	Currently supported	Manual installation / authentication	Junie CLI docs	Junie ACP docs	Supported now; finish Junie sign-in or token setup first. ACP mode uses junie --acp.
DSH	Currently supported	Manual installation / authentication	DeepSeek Harness repository	DeepSeek Harness repository	Supported now; install with npm install -g @deepseek-ai/dsh (pre-release, interfaces may change), and keep credentials in $DSH_HOME.

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 iFlow CLI is kept only for compatibility with old data. It is not part of the current active support range and should not be treated as a currently recommended option.

Recommended next steps

• Continue with Install Node.js if you still need to set up the base environment, and read the Introduction to OpenSpec as needed.
• If you want one local gateway for multiple OpenAI-compatible tools, continue with OmniRoute Installation and Usage.
• To try spec-driven development with these Agent CLIs, read Install Spec Kit and compare it in Spec Kit vs OpenSpec.
• Return to the Installation Guide for the broader installation path and prerequisites such as Node.js and Git.
• If you arrived here from a historical blog post, treat this page and the installation overview as the current evergreen source of truth.