Hagicode Desktop

Hagicode offers two deployment options: Desktop version and Server version. Each has its advantages, but both adopt a user-controlled server and data approach, providing better data protection.

Desktop Version

• Runs locally on your computer, more lightweight
• No server configuration needed, ready to use out of the box
• Suitable for individual developers and light usage scenarios
• All data completely localized

Server Version

• Can be deployed on remote servers
• Supports multi-user remote access
• Better suited for team collaboration and scaling
• Prepares for future enterprise features and multi-device sync

Whichever version you choose, you have complete control over your server and data, enjoying better privacy protection and data security.

Hagicode Desktop is essentially a launcher. On first launch after installation, it will guide you through these steps:

• Download Hagicode Core: Desktop will automatically detect and prompt you to download Hagicode core components
• Install Core Components: Follow the on-screen prompts to complete core component installation
• Configure your default Agent CLI: Choose a currently supported Agent CLI and finish the required sign-in, authorization, or local installation steps.

The Desktop interface guides the whole flow. Keep the network available on first launch so Hagicode Core can download; some Agent CLIs still require manual installation or authentication, but they are still part of the current support range.

After completing these steps, you can use all Hagicode Desktop features normally.

Desktop automatically checks for updates. When a new version is available, a prompt will appear in the top right corner of the interface. You can also manually check for updates in "Settings".

Hagicode Desktop currently supports the following Agent CLIs:

• Currently supported: Claude Code, Codex, GitHub Copilot, OpenCode, Hermes, QoderCLI, Kiro, Kimi, Gemini, DeepAgents, and Codebuddy
• Manual installation or authentication: Hermes, Gemini, and DeepAgents require a local install or auth step first; the other CLIs provide one-click installation entry points or guided install flows.
• Legacy compatibility only: IFlowCli remains only for historical data compatibility and is not part of the current active support range.

Support scope and setup mode are separate concerns. A CLI that needs manual installation is still supported now.

Yes! Hagicode Desktop supports complete offline usage:

• Network connection required for initial installation and configuration (downloading core components and AI models)
• All features can be used offline after configuration
• Your code and data are never uploaded to the cloud
• All AI processing is completed locally

If Hagicode Desktop is installed in the default path /Applications/Hagicode.app and macOS Gatekeeper blocks the first launch, use the following command to remove the quarantine attribute from the app.

This happens because macOS adds the com.apple.quarantine attribute to apps downloaded from the internet. It is a macOS security isolation issue, not a failure in the Hagicode installer.

sudo xattr -dr com.apple.quarantine /Applications/Hagicode.app

Run the command in Terminal with administrator privileges, then relaunch Hagicode Desktop.

If you encounter issues while using Hagicode Desktop, you can get help through:

• Technical Support Group: Join QQ Group 610394020
• Online Documentation: View complete usage documentation and tutorials
• GitHub Issues: Submit issue reports in the project repository