Guide
How to use rezero.md
rezero.md turns any public website into evidence-aware Markdown docs that your AI coding agent can read. It runs entirely in your terminal — no browser extension, no account, nothing to install.
Before you start
- Node.js 22 or newer (check with node -v).
- A terminal open in your project folder.
- No account and no API key required to begin.
Quickstart
Run one command. npx downloads the package on first use, so there is nothing to install first.
1. Analyze a site
Point it at any public URL. It crawls the public pages and writes eight Markdown docs into .rezero/<domain>/ in the current folder.
$ npx rezero-md analyze https://linear.app2. Or scaffold for your agent with init
init does the same analysis, then also writes agent context files (CLAUDE.md, AGENTS.md, .cursor rules and more) at the root of your project so your AI tool picks them up automatically.
$ npx rezero-md init https://linear.appWhat you get
Eight evidence-aware documents in .rezero/<domain>/, each separating observation from inference from recommendation:
init adds agent-ready context files at your project root so coding tools read them with no setup:
How it works
Every document is built on the same honest principle — evidence before opinion. It is for learning how a product is built, never for cloning it.
Observe
Public metadata, structure, links, interface tokens, and technical signatures — only what the page actually serves.
Infer
Cautious hypotheses with visible confidence, clearly labeled as guesses rather than facts.
Recommend
Transferable guidance so you can adapt a pattern to your own product — not copy the original.
Use it in your AI tool
The output is plain Markdown in your repo, so any agent can read it. For the popular tools:
Claude Code
Automatic. Claude Code reads CLAUDE.md and AGENTS.md at the repo root. Run claude in the folder and ask it to use the rezero.md reference.
Cursor
Automatic. The generated .cursor/rules/rezero.mdc guides Cursor’s suggestions. You can also @-mention files inside .rezero/ in chat.
Codex CLI
Reads AGENTS.md automatically. Run codex in the folder, or point it at the docs in .rezero/<domain>/.
Gemini CLI
Reference the generated Markdown in your prompt — e.g. “use the files in .rezero/<domain>/ as design context”.
Any other agent
Windsurf, Cline, Continue and others: everything is plain Markdown in .rezero/, so add those files to the tool’s context.
Full AI generation (optional)
Without a key, rezero.md writes deterministic starter documents so you can see the shape instantly. Set GEMINI_API_KEY (or OPENAI_API_KEY) for full AI-written analysis. Your key and files stay on your machine.
$ export GEMINI_API_KEY=your_key_here$ npx rezero-md init https://linear.appTroubleshooting
The command does nothing or is “not found”.
Confirm Node.js 22+ with node -v, then run npx rezero-md analyze <url>. npx downloads the package on first run; no global install is needed.
The documents look thin or generic.
That is the no-key starter output. Set GEMINI_API_KEY (or OPENAI_API_KEY) for full analysis, or browse the library where entries are already fully generated.
“No public HTML pages could be fetched.”
The target must be a public page that allows crawling. Use the site’s public landing URL and make sure it is not behind a login or blocking bots.
Where are the files?
In .rezero/<domain>/ inside the folder where you ran the command — plus CLAUDE.md, AGENTS.md and the other context files when you use init.
Ready to try it?
Browse products already analyzed, or generate your own in one command.