Hanzo Dev - AI-Powered Development Platform

Hanzo Dev is an AI-powered development platform -- a monorepo containing a Rust-native CLI (`dev`, `dev-tui`, `dev-exec`), a Node.js wrapper CLI (`@hanzo/dev`), a legacy TypeScript CLI (`codex-cli`...

Overview

Hanzo Dev is an AI-powered development platform -- a monorepo containing a Rust-native CLI (dev, dev-tui, dev-exec), a Node.js wrapper CLI (@hanzo/dev), a legacy TypeScript CLI (codex-cli), and supporting infrastructure including an app server, MCP client/server, and cloud task system. Built with Bazel + Cargo.

Upstream fork: OpenAI Codex CLI. The codex-cli/ and codex-rs/ directories preserve the upstream lineage. The Rust rewrite lives in hanzo-dev/ as a Cargo workspace with 40+ crates.

What it actually is

hanzo-dev/ -- Rust workspace (v0.6.74), the primary CLI. Builds three binaries: dev, dev-tui, dev-exec. Contains 40+ crates: core, cli, tui, exec, execpolicy, mcp-client, mcp-server, protocol, git-tooling, file-search, linux-sandbox, ollama, login, browser, chatgpt, cloud-tasks, otel, and more.

dev-cli/ -- Node.js wrapper package @hanzo/dev (v0.6.61) published to npm. Provides dev and hanzo binaries that delegate to platform-specific native binaries (@hanzo/dev-darwin-arm64, etc.).

codex-cli/ -- Legacy TypeScript CLI from the upstream Codex fork.

codex-rs/ -- Upstream Rust codebase (preserved for reference).

hanzo-cli/ -- Additional CLI entry point.

hanzo-node/ -- Node.js integration layer.

code-rs/ -- Code editor integration.

sdk/ -- SDKs (includes sdk/python/ with codex-app-server-sdk).

console/ -- Console UI.

contracts/ -- Smart contracts.

Build system: Bazel (MODULE.bazel, BUILD.bazel, defs.bzl, .bazelrc) + Cargo + pnpm.

What it is NOT

Not installable via cargo install hanzo-dev or pip install hanzo-dev

No .hanzorc config file format

Not a local-only inference tool -- it connects to LLM providers (OpenAI, Anthropic, Ollama, etc.)

When to use

AI-assisted coding from the terminal

Multi-file code generation and editing

Git-aware code review and commit workflows

MCP tool integration for development tasks

Quick reference

Item	Value
Repo	`github.com/hanzoai/dev`
Rust workspace	`hanzo-dev/` (v0.6.74, 40+ crates)
npm package	`@hanzo/dev` (v0.6.61)
Binaries (Rust)	`dev`, `dev-tui`, `dev-exec`
Binaries (npm)	`dev`, `hanzo`
Upstream	OpenAI Codex CLI
Build (Rust)	`cd hanzo-dev && cargo build --release --bin dev --bin dev-tui --bin dev-exec`
Build (Bazel)	`bazel build //...`
Build (quick)	`./build-fast.sh`
Format	`pnpm format` (prettier), `cargo fmt` (Rust)
Test	`cargo test` (Rust), `pnpm test:local`
Package manager	pnpm >= 10.29.3
Node	>= 22
Rust edition	2024
License	Apache-2.0

Repository structure

hanzoai/dev/
  MODULE.bazel          # Bazel module definition
  BUILD.bazel           # Root build file
  defs.bzl              # Bazel macros
  .bazelrc              # Bazel config
  package.json          # pnpm monorepo root
  pnpm-workspace.yaml   # Workspace members
  hanzo.sh              # Install script
  build-fast.sh         # Fast build script
  justfile              # Just task runner
  hanzo-dev/            # PRIMARY: Rust workspace (40+ crates)
    Cargo.toml          # Workspace manifest (v0.6.74)
    cli/                # CLI binary crate
    tui/                # TUI binary crate
    exec/               # Exec binary crate
    core/               # Core agent logic
    mcp-client/         # MCP client
    mcp-server/         # MCP server
    protocol/           # Wire protocol
    browser/            # Browser integration
    ollama/             # Ollama provider
    login/              # Auth/login
    linux-sandbox/      # Sandboxing
    file-search/        # File search
    git-tooling/        # Git operations
    ...                 # 25+ more crates
  dev-cli/              # npm wrapper (@hanzo/dev v0.6.61)
    bin/dev.js          # Entry point
    package.json        # Publishes `dev` and `hanzo` binaries
  codex-cli/            # Legacy TS CLI (upstream fork)
  codex-rs/             # Upstream Rust (preserved)
  code-rs/              # Code editor integration
  hanzo-cli/            # Additional CLI
  hanzo-node/           # Node.js integration
  sdk/                  # SDKs (Python, etc.)
  console/              # Console UI
  contracts/            # Smart contracts
  platform/             # Platform integration
  shell-tool-mcp/       # Shell MCP server
  npm-binaries/         # Platform-specific npm binary packages
  standalone-hanzo-dev/ # Standalone build
  published-hanzo-dev/  # Published crate

Rust workspace crates (hanzo-dev/)

Crate	Purpose
`cli`	Main CLI binary (`dev`)
`tui`	Terminal UI binary (`dev-tui`)
`exec`	Execution binary (`dev-exec`)
`core`	Core agent logic
`common`	Shared types
`protocol`	Wire protocol definitions
`mcp-client`	MCP client implementation
`mcp-server`	MCP server implementation
`mcp-types`	MCP type definitions
`browser`	Browser automation
`chatgpt`	ChatGPT integration
`ollama`	Ollama provider
`login`	Authentication
`exec`	Command execution
`execpolicy`	Execution policy/sandboxing
`file-search`	File search
`git-tooling`	Git operations
`git-apply`	Git patch application
`apply-patch`	Patch application
`linux-sandbox`	Linux sandboxing
`app-server`	App server
`app-server-protocol`	Server protocol
`backend-client`	Backend API client
`cloud-tasks`	Cloud task execution
`otel`	OpenTelemetry
`tunnel-bridge`	Tunnel bridge
`code-auto-drive-core`	Auto-drive coding
`responses-api-proxy`	Responses API proxy

Installation

# Via npm (recommended -- auto-selects platform binary)
npm install -g @hanzo/dev

# Via install script
curl -fsSL https://raw.githubusercontent.com/hanzoai/dev/main/hanzo.sh | sh

# From source (Rust)
git clone https://github.com/hanzoai/dev.git
cd dev/hanzo-dev
cargo build --release --bin dev --bin dev-tui --bin dev-exec

# From source (quick)
git clone https://github.com/hanzoai/dev.git
cd dev
./build-fast.sh

Usage

# Interactive session
dev

# TUI mode
dev-tui

# Inline prompt
dev "Explain this code"

# With specific model
dev --model gpt-4o "Fix the build errors"

Configuration

Configuration is via config.toml (see config.toml.example in repo root). The Rust CLI reads config from standard XDG paths, not a .hanzorc file.

hanzo/hanzo-mcp.md -- MCP tools used by dev

hanzo/hanzo-extension.md -- VS Code/JetBrains/browser extensions

Hanzo Dev - AI-Powered Development Platform

On this page