Something went wrong. Try again.
zig langref cli nate.tngl.io/zigman
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>zigman - the Zig language reference in your terminal</title><meta name="description" content="zigman reads the official Zig language reference in your terminal, caches it, and prints matching sections as clean markdown for humans and agents."><link rel="stylesheet" href="site.css"><script defer src="nav.js"></script></head><body><main> <section class="window" aria-labelledby="title"> <nav class="bar" aria-label="Primary"> <a data-nav-item data-hotkey="p" href="prompt.md">setup</a> <a data-nav-item data-hotkey="g" data-nav-target="guide" href="guide.html">guide</a> <a data-nav-item data-hotkey="l" data-nav-target="llms" href="llms.txt">llms</a> <a data-nav-item data-hotkey="s" href="https://tangled.org/zzstoatzz.io/zigman">source</a> <a data-nav-item data-hotkey="r" href="https://ziglang.org/documentation/master/">langref</a> </nav>
<div class="brand"> <div> <h1 id="title">zigman</h1> <p class="lede">The official Zig language reference, cached locally and rendered as clean markdown in your terminal.</p> </div> <div class="card" aria-label="Status"> <div class="frame-top"><div class="card-title">status</div></div> <div class="card-body"> <p><span class="muted">surface</span> <span class="badge">static binary</span></p> <p><span class="muted">scope</span> language reference, not stdlib</p> <p><span class="muted">built for</span> humans, shell pipes, and coding agents</p> </div> </div> </div>
<div class="section" id="install"> <h2>install</h2> <pre class="terminal"><code>curl -fsSL https://nate.tngl.io/zigman/install.sh | sh</code></pre> <p class="muted">macOS and Linux, aarch64 and x86_64. Installs to <code>$ZIGMAN_INSTALL</code> or <code>~/.local/bin</code>.</p> </div>
<div class="section grid" aria-label="Offerings"> <div class="card"> <div class="frame-top"><div class="card-title">lookup</div></div> <div class="card-body"> <p>Type any part of a section name. One match renders the section; many matches render a candidate list.</p> </div> </div> <div class="card"> <div class="frame-top"><div class="card-title">cache</div></div> <div class="card-body"> <p>Fetches the single-page Zig langref once, then reads from <code>$XDG_CACHE_HOME</code> or <code>~/.cache</code>.</p> </div> </div> <div class="card"> <div class="frame-top"><div class="card-title">skill</div></div> <div class="card-body"> <p>Ships a cross-client <code>SKILL.md</code> so agents know when to read Zig semantics instead of guessing.</p> </div> </div> </div>
<div class="section grid two" id="use"> <div> <h2>use</h2> <pre class="terminal"><code>zigman comptimezigman errorzigman -o comptimezigman -lzigman -V 0.15.1 comptime</code></pre> </div> <div> <h2>contracts</h2> <table class="spec"> <thead> <tr><th>command</th><th>behavior</th></tr> </thead> <tbody> <tr><td><code>zigman <query></code></td><td>render one matching section as markdown</td></tr> <tr><td><code>zigman -l</code></td><td>list the whole table of contents</td></tr> <tr><td><code>zigman -o</code></td><td>open the matching langref anchor in a browser</td></tr> <tr><td><code>zigman --no-pager</code></td><td>raw deterministic output for tools</td></tr> </tbody> </table> </div> </div>
<div class="section grid two" id="agent-loop"> <div class="card"> <div class="frame-top"><div class="card-title">agent loop</div></div> <div class="card-body"> <p>Give a weak local model a Zig task and the <code>zigman</code> tool. Score the final file with <code>zig test</code>. When the tool helps, keep the pattern. When it fails, improve the lookup surface.</p> <ul> <li>objective oracle: the compiler</li> <li>quality signal: tool-call trace</li> <li>goal: measurable lift over a bare model</li> </ul> </div> </div> <div class="actions" aria-label="Links"> <a data-nav-item data-hotkey="r" class="action" href="https://ziglang.org/documentation/master/"><b>></b><span>read the official Zig language reference</span><kbd>R</kbd></a> <a data-nav-item data-hotkey="p" class="action" href="prompt.md"><b>></b><span>read the agent setup prompt</span><kbd>P</kbd></a> <a data-nav-item data-hotkey="g" class="action" href="guide.html"><b>></b><span>read the practical zigman workflow guide</span><kbd>G</kbd></a> <a data-nav-item data-hotkey="l" class="action" href="llms.txt"><b>></b><span>read the llms.txt index for agents</span><kbd>L</kbd></a> <a data-nav-item class="action" href="skill.md"><b>></b><span>fetch the canonical zigman skill</span><kbd>SK</kbd></a> <a data-nav-item data-hotkey="s" class="action" href="https://tangled.org/zzstoatzz.io/zigman"><b>></b><span>view the source on tangled</span><kbd>S</kbd></a> <a data-nav-item data-hotkey="c" class="action" href="https://github.com/internet-development/www-sacred"><b>></b><span>aesthetic adapted from Sacred Computer / SRCL</span><kbd>C</kbd></a> <a data-nav-item data-hotkey="i" class="action" href="install.sh"><b>></b><span>inspect the install script</span><kbd>I</kbd></a> </div> </div>
<div class="section"> <details> <summary>build from source</summary> <pre class="terminal"><code>git clone https://tangled.org/zzstoatzz.io/zigmancd zigmanzig build -Doptimize=ReleaseSafe</code></pre> </details> <details> <summary>shell completion</summary> <pre class="terminal"><code>eval "$(zigman --completions zsh)"eval "$(zigman --completions bash)"zigman --completions fish | source</code></pre> </details> <details> <summary>options and paging</summary> <pre class="terminal"><code>-l, --list list section names instead of rendering-o, --open open the section in your browser-V, --version <ver> langref version to read-r, --refresh bypass the cache and refetch --no-pager do not page terminal output-h, --help show help</code></pre> </details> </div> </section></main></body></html>