Installation
Install Hanzo Dev from npm, Homebrew, or build from source.
System Requirements
| Requirement | Details |
|---|---|
| Operating systems | macOS 12+, Ubuntu 20.04+/Debian 10+, or Windows 11 via WSL2 |
| Git (optional, recommended) | 2.23+ for built-in PR helpers |
| RAM | 4 GB minimum (8 GB recommended) |
Install via npm
npm install -g @hanzo/devInstall via npx
npx @hanzo/devDotSlash
The GitHub Release also contains a DotSlash file for Hanzo Dev named dev. Using a DotSlash file makes it possible to make a lightweight commit to source control to ensure all contributors use the same version of the executable, regardless of platform.
Build from Source
# Clone the repository and navigate to the Cargo workspace
git clone https://github.com/hanzoai/dev.git
cd dev/codex-rs
# Install the Rust toolchain if necessary
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
rustup component add rustfmt
rustup component add clippy
# Install helper tools
cargo install just
# Optional: install nextest for faster tests
cargo install cargo-nextest
# Build
cargo build
# Launch the TUI with a sample prompt
cargo run --bin codex -- "explain this codebase to me"
# After making changes, use the root justfile helpers:
just fmt
just fix -p <crate-you-touched>
# Run the relevant tests
cargo test -p codex-tui
# Or full test suite:
just test
cargo test --all-featuresTracing / Verbose Logging
Hanzo Dev is written in Rust and honors the RUST_LOG environment variable.
The TUI defaults to RUST_LOG=codex_core=info,codex_tui=info,codex_rmcp_client=info and writes logs to ~/.hanzo/log/codex-tui.log. Override the log directory with -c log_dir=... for a single run.
tail -F ~/.hanzo/log/codex-tui.logNon-interactive mode (dev exec) defaults to RUST_LOG=error with inline output.
See the Rust RUST_LOG documentation for all configuration options.