Files
zeekay 747dafba10 Register WebMCP tools on every page, and name each page's twin from site.py
Every page now loads /webmcp.js, scripts/webmcp.ts with its types
stripped (npm run webmcp). Where the browser has document.modelContext
it registers two read-only tools: search_skills over the published
skills index, and get_skill, which returns a skill's markdown checked
against the index digest. The markdown alternate link moves from
build.py to site.py, so CI holds every page to it.

The API catalog gains the site itself (llms.txt and the skills index)
and hanzo.ai/agents; the live discovery check now fetches every
catalog link. tests/site.mjs drives the tools through a recording
modelContext, and checks a browser without one loads clean.
2026-10-26 20:57:05 -07:00

310 lines
20 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-dev</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-dev">
<link rel="alternate" type="text/markdown" href="/hanzo-dev.md">
<script type="module" src="/webmcp.js"></script>
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-dev.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hanzo-dev</h1><p class="lede">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</p><h1>Hanzo Dev - AI-Powered Development Platform</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-mcp.md</code>, <code>hanzo/hanzo-extension.md</code></p>
<h2>Overview</h2>
<p>Hanzo Dev is an <strong>AI-powered development platform</strong> -- a monorepo containing a Rust-native CLI (<code>dev</code>, <code>dev-tui</code>, <code>dev-exec</code>), a Node.js wrapper CLI (<code>@hanzo/dev</code>), a legacy TypeScript CLI (<code>codex-cli</code>), and supporting infrastructure including an app server, MCP client/server, and cloud task system. Built with Bazel + Cargo.</p>
<p><strong>Upstream fork</strong>: OpenAI Codex CLI. The <code>codex-cli/</code> and <code>codex-rs/</code> directories preserve the upstream lineage. The Rust rewrite lives in <code>hanzo-dev/</code> as a Cargo workspace with 40+ crates.</p>
<h3>What it actually is</h3>
<ul><li><strong><code>hanzo-dev/</code></strong> -- Rust workspace (v0.6.74), the primary CLI. Builds three binaries: <code>dev</code>, <code>dev-tui</code>, <code>dev-exec</code>. 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.</li><li><strong><code>dev-cli/</code></strong> -- Node.js wrapper package <code>@hanzo/dev</code> (v0.6.61) published to npm. Provides <code>dev</code> and <code>hanzo</code> binaries that delegate to platform-specific native binaries (<code>@hanzo/dev-darwin-arm64</code>, etc.).</li><li><strong><code>codex-cli/</code></strong> -- Legacy TypeScript CLI from the upstream Codex fork.</li><li><strong><code>codex-rs/</code></strong> -- Upstream Rust codebase (preserved for reference).</li><li><strong><code>hanzo-cli/</code></strong> -- Additional CLI entry point.</li><li><strong><code>hanzo-node/</code></strong> -- Node.js integration layer.</li><li><strong><code>code-rs/</code></strong> -- Code editor integration.</li><li><strong><code>sdk/</code></strong> -- SDKs (includes <code>sdk/python/</code> with codex-app-server-sdk).</li><li><strong><code>console/</code></strong> -- Console UI.</li><li><strong><code>contracts/</code></strong> -- Smart contracts.</li><li><strong>Build system</strong>: Bazel (<code>MODULE.bazel</code>, <code>BUILD.bazel</code>, <code>defs.bzl</code>, <code>.bazelrc</code>) + Cargo + pnpm.</li></ul>
<h3>What it is NOT</h3>
<ul><li>Not installable via <code>cargo install hanzo-dev</code> or <code>pip install hanzo-dev</code></li><li>No <code>.hanzorc</code> config file format</li><li>Not a local-only inference tool -- it connects to LLM providers (OpenAI, Anthropic, Ollama, etc.)</li></ul>
<h2>When to use</h2>
<ul><li>AI-assisted coding from the terminal</li><li>Multi-file code generation and editing</li><li>Git-aware code review and commit workflows</li><li>MCP tool integration for development tasks</li></ul>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | Repo | <code>github.com/hanzoai/dev</code> | | Rust workspace | <code>hanzo-dev/</code> (v0.6.74, 40+ crates) | | npm package | <code>@hanzo/dev</code> (v0.6.61) | | Binaries (Rust) | <code>dev</code>, <code>dev-tui</code>, <code>dev-exec</code> | | Binaries (npm) | <code>dev</code>, <code>hanzo</code> | | Upstream | OpenAI Codex CLI | | Build (Rust) | <code>cd hanzo-dev &amp;&amp; cargo build --release --bin dev --bin dev-tui --bin dev-exec</code> | | Build (Bazel) | <code>bazel build //...</code> | | Build (quick) | <code>./build-fast.sh</code> | | Format | <code>pnpm format</code> (prettier), <code>cargo fmt</code> (Rust) | | Test | <code>cargo test</code> (Rust), <code>pnpm test:local</code> | | Package manager | pnpm &gt;= 10.29.3 | | Node | &gt;= 22 | | Rust edition | 2024 | | License | Apache-2.0 |</p>
<h2>Repository structure</h2>
<pre><code>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</code></pre>
<h2>Rust workspace crates (hanzo-dev/)</h2>
<p>| Crate | Purpose | |-------|---------| | <code>cli</code> | Main CLI binary (<code>dev</code>) | | <code>tui</code> | Terminal UI binary (<code>dev-tui</code>) | | <code>exec</code> | Execution binary (<code>dev-exec</code>) | | <code>core</code> | Core agent logic | | <code>common</code> | Shared types | | <code>protocol</code> | Wire protocol definitions | | <code>mcp-client</code> | MCP client implementation | | <code>mcp-server</code> | MCP server implementation | | <code>mcp-types</code> | MCP type definitions | | <code>browser</code> | Browser automation | | <code>chatgpt</code> | ChatGPT integration | | <code>ollama</code> | Ollama provider | | <code>login</code> | Authentication | | <code>exec</code> | Command execution | | <code>execpolicy</code> | Execution policy/sandboxing | | <code>file-search</code> | File search | | <code>git-tooling</code> | Git operations | | <code>git-apply</code> | Git patch application | | <code>apply-patch</code> | Patch application | | <code>linux-sandbox</code> | Linux sandboxing | | <code>app-server</code> | App server | | <code>app-server-protocol</code> | Server protocol | | <code>backend-client</code> | Backend API client | | <code>cloud-tasks</code> | Cloud task execution | | <code>otel</code> | OpenTelemetry | | <code>tunnel-bridge</code> | Tunnel bridge | | <code>code-auto-drive-core</code> | Auto-drive coding | | <code>responses-api-proxy</code> | Responses API proxy |</p>
<h2>Installation</h2>
<pre><code class="lang-bash"># 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</code></pre>
<h2>Usage</h2>
<pre><code class="lang-bash"># Interactive session
dev
# TUI mode
dev-tui
# Inline prompt
dev &quot;Explain this code&quot;
# With specific model
dev --model gpt-4o &quot;Fix the build errors&quot;</code></pre>
<h2>Configuration</h2>
<p>Configuration is via <code>config.toml</code> (see <code>config.toml.example</code> in repo root). The Rust CLI reads config from standard XDG paths, not a <code>.hanzorc</code> file.</p>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-mcp.md</code> -- MCP tools used by dev</li><li><code>hanzo/hanzo-extension.md</code> -- VS Code/JetBrains/browser extensions</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: dev, coding, cli, terminal, rust, bazel, codex <strong>Prerequisites</strong>: Node.js &gt;= 22 (for npm wrapper) or Rust toolchain (for source build)</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hanzo-dev.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>