# Documentation

Start here when README is too small for the detail you need.

| Goal | File |
| --- | --- |
| Understand how ax-grep works | [how-it-works.md](./how-it-works.md) |
| Install the Codex skill prompt | [../skills/ax-grep-cli/SKILL.md](../skills/ax-grep-cli/SKILL.md) |
| Use CLI search and `--agent` output | [cli-agent.md](./cli-agent.md) |
| Build a minimal agent handoff loop | [agent-handoff.md](./agent-handoff.md) |
| Use as a server/library package | [library-api.md](./library-api.md) |
| Integrate with server-side agent SDKs | [server-agent.md](./server-agent.md) |
| Inject into WebViews or browser pages | [webview.md](./webview.md) |
| Check readiness before promotion | [agent-readiness.md](./agent-readiness.md) |
| Track current progress and next work | [progress.md](./progress.md) |
| Review feature details | [features.md](./features.md) |
| Run benchmarks and comparisons | [benchmarks.md](./benchmarks.md) |
| Publish with npm trusted publishing | [release.md](./release.md) |
| Read current `agent-browser` comparison notes | [comparison-baseline.md](./comparison-baseline.md) |

The root README should stay short: skill install first, server library usage
second, WebView/browser usage third, then links.