# zigman

> zigman is a single static binary that reads the official Zig language reference
> in a terminal. It fetches the single-page langref once, caches it, and renders a
> matching section as clean markdown for humans, shell pipelines, and coding
> agents.

## Project contracts

- [Homepage](https://nate.tngl.io/zigman/)
- [Agent setup prompt](https://nate.tngl.io/zigman/prompt.md)
- [Practical guide](https://nate.tngl.io/zigman/guide.html)
- [Canonical skill](https://nate.tngl.io/zigman/skill.md)
- [Install script](https://nate.tngl.io/zigman/install.sh)
- [Source repository](https://tangled.org/zzstoatzz.io/zigman)
- [Zig language reference](https://ziglang.org/documentation/master/)

## Agent guidance

- If you are setting up an environment, fetch and follow `https://nate.tngl.io/zigman/prompt.md`.
- Use `zigman <query>` when unsure about Zig language semantics.
- Use `zigman -l <word>` to discover exact section names.
- Use `zigman --no-pager <query>` in non-interactive tools.
- zigman covers the language reference, not the standard library.

## Source docs

- `README.md` documents install and basic usage.
- `DESIGN.md` documents the self-improvement loop and eval architecture.
- `docs/guide.md` documents practical shell and agent workflows.
- `skills/zigman/SKILL.md` is the cross-client agent skill.
