Files
skills/public/hanzo-tools.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

339 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-tools</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="alternate" type="text/markdown" href="/hanzo-tools.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-tools">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-tools.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-tools</h1><p class="lede">Hanzo Tools is a unified registry of 88 tools across 20 categories for all AI agent operations across the Hanzo and Zoo ecosystems.</p><h1>Hanzo Tools - Unified AI Agent Tool Registry</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-agent.md</code>, <code>hanzo/hanzo-mcp.md</code>, <code>hanzo/hanzo-node.md</code></p>
<h2>Overview</h2>
<p>Hanzo Tools is a <strong>unified registry of 88 tools across 20 categories</strong> for all AI agent operations across the Hanzo and Zoo ecosystems. Core implementation in Rust with Python (PyO3) and Node.js (NAPI-RS) bindings. Also contains pre-built agent definitions and supporting scripts.</p>
<h3>Why Hanzo Tools?</h3>
<ul><li><strong>One registry</strong>: Single source of truth for all agent tools across Hanzo Node, Zoo Node, and Hanzo Agent</li><li><strong>Type-safe</strong>: Rust core with JSON Schema validation for all tool parameters</li><li><strong>Cross-language</strong>: Python and Node.js bindings from the same Rust codebase</li><li><strong>Async execution</strong>: All tool execution is asynchronous</li><li><strong>Categorized</strong>: 20 logical categories for discoverability</li></ul>
<h3>Tech Stack</h3>
<ul><li><strong>Core</strong>: Rust</li><li><strong>Python bindings</strong>: PyO3 / maturin</li><li><strong>Node.js bindings</strong>: NAPI-RS</li><li><strong>Parameter validation</strong>: JSON Schema</li><li><strong>Scripts</strong>: TypeScript (Deno-compatible), Shell, Python</li><li><strong>License</strong>: Apache-2.0</li></ul>
<h3>Repo</h3>
<p><code>github.com/hanzoai/tools</code></p>
<h2>When to use</h2>
<ul><li>Providing tool capabilities to AI agents (Hanzo Agent, Zoo Node, custom agents)</li><li>Looking up available tools by category or name</li><li>Adding new tools to the unified registry</li><li>Building Rust/Python/Node.js applications that need tool execution</li><li>Packaging and deploying agent definitions</li></ul>
<h2>Hard requirements</h2>
<ol><li><strong>Rust</strong> for building the core registry</li><li><strong>maturin</strong> for Python bindings</li><li><strong>Node.js</strong> for NAPI-RS bindings</li></ol>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | Repo | <code>github.com/hanzoai/tools</code> | | Language | Rust (core), TypeScript (scripts), Python (tests) | | Total tools | 88 | | Total categories | 20 | | Rust crate | <code>hanzo-tools</code> | | Python module | <code>hanzo_tools</code> | | npm package | <code>@hanzo/tools</code> | | Catalog | <code>CATALOG.json</code> (43KB, machine-readable) | | Manifest | <code>tools-manifest.json</code> |</p>
<h2>Tool categories</h2>
<p>| Category | Count | Tools | |----------|-------|-------| | <strong>filesystem</strong> | 10 | read, write, directory_tree, tree, watch, diff, rules, content_replace, find, grep | | <strong>shell</strong> | 15 | run_command, run, run_background, python_execute, processes, ps, pkill, kill, logs, open, npx, uvx, pkg, zsh, streaming_command | | <strong>agent</strong> | 7 | agent, swarm, claude, critic, review, clarification, network | | <strong>database</strong> | 7 | db, sql, graph, sql_query, sql_search, graph_add, graph_query | | <strong>system</strong> | 6 | tool_enable, tool_disable, tool_list, stats, mode, config | | <strong>search</strong> | 5 | unified_search, search, web_search, batch_search, symbols | | <strong>project</strong> | 5 | project_analyze, dependency_tree, build_project, test_run, refactor_code | | <strong>memory</strong> | 4 | memory, recall_memories, store_facts, summarize_to_memory | | <strong>todo</strong> | 3 | todo, todo_read, todo_write | | <strong>mcp</strong> | 3 | mcp, mcp_add, mcp_stats | | <strong>editor</strong> | 3 | neovim_edit, neovim_command, neovim_session | | <strong>llm</strong> | 3 | llm, consensus, llm_manage | | <strong>jupyter</strong> | 3 | jupyter, notebook_read, notebook_edit | | <strong>git</strong> | 3 | git, git_status, git_search | | <strong>edit</strong> | 3 | edit, multi_edit, apply_patch | | <strong>vector</strong> | 2 | vector_index, vector_search | | <strong>ast</strong> | 2 | ast, ast_multi_edit | | <strong>browser</strong> | 2 | screenshot, navigate | | <strong>thinking</strong> | 1 | think | | <strong>lsp</strong> | 1 | lsp |</p>
<h2>Build commands</h2>
<pre><code class="lang-bash"># Build the Rust core
cd rust/
cargo build --release
# Run tests
cargo test
# Generate catalog
cargo run --example generate_catalog &gt; ../CATALOG.json
# Python bindings
pip install maturin
maturin develop
# Node.js bindings
npm install
npm run build</code></pre>
<h2>Usage</h2>
<h3>Rust</h3>
<pre><code class="lang-rust">use hanzo_tools::Registry;
let registry = Registry::new();
let tools = registry.list_tools();
// Execute a tool
let result = registry.execute(&quot;read&quot;, json!({
&quot;path&quot;: &quot;/path/to/file.txt&quot;
})).await?;</code></pre>
<h3>Python</h3>
<pre><code class="lang-python">from hanzo_tools import ToolRegistry
registry = ToolRegistry()
tools = registry.list_tools()
result = await registry.execute(&quot;read&quot;, {
&quot;path&quot;: &quot;/path/to/file.txt&quot;
})</code></pre>
<h3>Node.js</h3>
<pre><code class="lang-javascript">const { Registry } = require(&#x27;@hanzo/tools&#x27;);
const registry = new Registry();
const tools = registry.listTools();</code></pre>
<h2>Architecture</h2>
<pre><code>hanzo-tools (Rust)
ToolRegistry (88 tools, 20 categories)
JSON Schema validation
Async execution
|
+-- Python bindings (PyO3) --&gt; Hanzo Agent (Python)
+-- Node.js bindings (NAPI-RS)
+-- Direct Rust dependency --&gt; Hanzo Node, Zoo Node</code></pre>
<h2>Key directories</h2>
<pre><code>rust/ # Rust core implementation
Makefile # Build automation
build.py # Build script
test_integration.py # Integration tests
README.md # Rust-specific docs
tools/ # Tool definitions (large, 100+ entries)
agents/ # Pre-built agent definitions
audio-insight/
bitcoin-chart-analyst/
bitcoin-market-analyst/
bitcoiner/
code-directory-and-git-repository-analyzer/
corporate-treasury-analyzer/
e-librarian/
enhanced-image-generator/
finance_bro/
image-analyzer/
learning_tutor/
linear_agent/
markdown-content-writer/
math_problem_solver/
mind-map-creator/
poster-creator/
prompt_writer/
youtube_expert/
... (35 total)
scripts/ # TypeScript utility scripts
download_agents.ts # Agent download/sync
download_tools.ts # Tool download/sync
build_tools.ts # Tool build script
launch.ts # Launch script
generate_images.ts # Image generation
run_node.sh # Node runner
tests/ # Script tests
crons/ # Scheduled tasks
fetch_usa_news.json # News fetching cron config
CATALOG.json # Machine-readable tool catalog (43KB)
AGENTS_CATALOG.json # Machine-readable agent catalog (10KB)
tools-manifest.json # Registry manifest with stats and integration info
package_agents.sh # Agent packaging script
run_zoo_with_agents.sh # Zoo integration runner
verify_agents.py # Agent verification script</code></pre>
<h2>Adding a new tool</h2>
<ol><li>Add tool definition to <code>src/registry.rs</code> in the appropriate category</li><li>Implement execution logic in the category-specific execution method</li><li>Run tests: <code>cargo test</code></li><li>Regenerate catalog: <code>cargo run --example generate_catalog &gt; ../CATALOG.json</code></li><li>Update README.md</li></ol>
<h2>Integration points</h2>
<p>| Consumer | Method | |----------|--------| | Hanzo Node (Rust) | Direct Rust crate dependency | | Zoo Node (Rust) | Direct Rust crate dependency | | Hanzo Agent (Python) | Python bindings via PyO3 | | MCP Server | Tool definitions exported as MCP-compatible schemas |</p>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-agent.md</code> - Multi-agent SDK (Python, primary consumer)</li><li><code>hanzo/hanzo-mcp.md</code> - Model Context Protocol tools</li><li><code>hanzo/hanzo-node.md</code> - Hanzo Node (Rust, direct dependency)</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: tools, agents, registry, rust, mcp, ai-agents <strong>Prerequisites</strong>: Rust, Python (for bindings), Node.js (for bindings)</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-tools.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>