This repository builds the organization root site and the public agentctl documentation at /agentctl/. Technical content is canonical in opensourceops/agentctl; a deterministic manifest imports it into an Astro and Starlight presentation layer.
- Node.js 22 or newer
- pnpm 11.9.0 through Corepack
- Rust 1.88.0 and Cargo
- Playwright Chromium for the full browser gate
- local checkouts of this repository and
agentctl
Set AGENTCTL_REPO when the agentctl checkout is not in a documented sibling location.
corepack enable
pnpm install
pnpm exec playwright install chromium
AGENTCTL_REPO=/path/to/agentctl pnpm docs:sync
pnpm dev:agentctl
The development URL is http://localhost:4321/agentctl/. The development server makes no provider request, but dependency installation can use the package registry.
AGENTCTL_REPO=/path/to/agentctl pnpm build
AGENTCTL_REPO=/path/to/agentctl pnpm verify:agentctl
pnpm build writes the complete Pages artifact to _site; serve that directory at its root and open /agentctl/. pnpm verify:agentctl is the canonical cross-repository gate. It runs cargo xtask docs-verify, synchronizes canonical content, checks writing, spelling, links, anchors, Mermaid, search, and generated freshness, builds the final artifact, then runs responsive Playwright and axe checks.
Common failures are a missing AGENTCTL_REPO, stale generated source or CLI references, a missing Playwright browser, or another process using port 4173. No verification command needs a provider API key.
See deployment settings and the documentation execution ledger.