Installation Guide
Edit pageHagiCode supports multiple installation paths. Start with the deployment method that fits your scenario, then add supporting software only when you need it.
The current active Agent CLI support range most relevant to setup is: Claude Code, Codex, GitHub Copilot, OpenCode, Hermes, QoderCLI, Kiro, Kimi, Gemini, DeepAgents, and Codebuddy. Hermes, Gemini, and DeepAgents currently use manual installation or authentication flows; the other CLIs expose one-click installation entry points or guided install flows.
Choose an Installation Path
Section titled “Choose an Installation Path” Desktop Installation A guided graphical setup and management flow for individual users and developers who want to get started quickly.
Docker Compose Installation Best for isolated environments, standardized deployments, or team usage.
Supporting Software
Section titled “Supporting Software”If your setup needs extra tooling or runtimes, continue with these companion guides:
Install Node.js Prepare the Node.js and npm environment used by OpenSpec and most one-click Agent CLI installation flows.
Install OpenSpec Install the specification-driven development tool used to manage proposals, specs, and changes.
Install AI Agent CLI Use one registry for all 11 currently supported Agent CLIs, including one-click versus manual setup notes.
Recommended Next Steps
Section titled “Recommended Next Steps”- If you are new to HagiCode, start with Desktop Installation.
- If you are deploying for a server or team environment, use Docker Compose Installation.
- If you need to confirm support state, setup mode, or historical compatibility notes for a CLI, open AI Agent CLI Installation.