// agent-ready docs for astro sites

Docs your agents
can run.

One Astro integration, two surfaces: a ⌘K overlay for your readers, and a keyless CLI their coding agents drive — search, read, cite — over an ask digest, a token-efficient distillation of your docs.

Read the docs

A stack of documentation pages distilled into a compact digest.json index card on warm paper; an orange ⌘K beam reads it progressively — skims the index, lifts one summary line, and unfolds it into a full section anchored at #api/endpoints/create.

install
```
pnpm add @hevmind/ask
```

// astro.config.mjs
integrations: [hevAsk({ collections: ["docs"] })]

drop in the overlay
```
// any layout
<SearchOverlay />
```

That's the whole integration. This site runs on it — keyword search needs no API key. Full quick start →

// and for their agents

install the CLI — no MCP server, no config

go install github.com/hev/ask/cmd/ask@latest

point it at any hev-ask site

ask --endpoint https://yourdocs.com/api/ask search "how do I…"

Your docs become a tool any agent can call from a shell: ranked search, per-section reads, a glossary that resolves your product's vocabulary — every read keyless, every citation a CI-verified anchor. A one-file skill teaches the agent when to reach for it. CLI reference →

readers ⌘K — instant keyword search; Enter streams a grounded Claude answer
agents ask search / section get / overview — keyless reads over the same digest, from any shell
cited every answer deep-links to the exact heading — anchors verified in CI

// show, don't tell See what the agent sees → The rendered ask digest for this site — the distilled summaries and verbatim facts Claude reasons over. Injected, committed, reviewable.

how it works tradeoffs limits source

Docs your agentscan run.

Docs your agents
can run.