hanzo-dev

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 ser

Hanzo Dev - AI-Powered Development Platform

Category: Hanzo Ecosystem Related Skills: hanzo/hanzo-mcp.md, hanzo/hanzo-extension.md

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

What it is NOT

When to use

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.

Related Skills

Last Updated: 2026-03-13 Category: Hanzo Ecosystem Related: dev, coding, cli, terminal, rust, bazel, codex Prerequisites: Node.js >= 22 (for npm wrapper) or Rust toolchain (for source build)