npm i -g @hanzo/dev
or pip install hanzo-dev

Hanzo Dev is an AI-powered coding agent that runs locally on your computer, based on OpenAI Codex with GPT-5 readiness.

Built by Hanzo AI - Advanced AI infrastructure and tooling
If you want Hanzo Dev in your code editor (VS Code, Cursor, Windsurf), install in your IDE
For the cloud-based version, visit hanzo.ai/dev

Install globally with your preferred package manager. If you use npm:

npm install -g @hanzo/dev

Alternatively, if you use pip:

pip install hanzo-dev

Then simply run hanzo to get started:

hanzo

Run hanzo and select Sign in with your AI provider. Hanzo Dev supports multiple AI providers including OpenAI (GPT-5 ready), Anthropic Claude, and local models. You can sign in with your ChatGPT account to use as part of your Plus, Pro, Team, Edu, or Enterprise plan.

You can also use Hanzo Dev with an API key from any supported provider. See authentication documentation for setup details. If you're having trouble with login, please visit our support.

Hanzo Dev supports MCP servers with enhanced capabilities. Enable by adding an mcp_servers section to your ~/.hanzo/config.toml.

Hanzo Dev supports a rich set of configuration options, with preferences stored in ~/.hanzo/config.toml. For full configuration options, see Configuration.

• Getting started
  • CLI usage
  • Running with a prompt as input
  • Example prompts
  • Memory with AGENTS.md
  • Configuration
• Sandbox & approvals
• Authentication
  • Auth methods
  • Login on a "Headless" machine
• Advanced
  • Non-interactive / CI mode
  • Tracing / verbose logging
  • Model Context Protocol (MCP)
• Zero data retention (ZDR)
• Contributing
• Install & build
  • System Requirements
  • DotSlash
  • Build from source
• FAQ
• Open source fund

This repository is licensed under the Apache-2.0 License.