Files
esh-pfi-infrastructure/docs/fleettools/playwright.md
T
vh 53c3e8000e docs: add FleetTools — an agent-family-agnostic index of fleet capability
Every agent on nh3-dev — Claude, Codex, Grok, Aider — needs the same
answers: what runs here, how do I call it, what will bite me. Until now
that lived in ~/.claude/CLAUDE.md, which only Claude sessions load, and
it was interleaved with operator preferences that other families have
no use for.

Two-tier by design, matching the persistent-memory split: FLEETTOOLS.md
is a 135-line index an agent reads whole, and each entry links to a
detail file it opens only when it actually needs that tool. Reading the
index costs about a fifth of reading the tree.

Detail paths are absolute so they resolve from any working directory,
since a non-Claude agent will cat the path rather than follow a
markdown link. ~/FLEETTOOLS.md symlinks to the index for discovery.

Rule zero is that live inventories get queried, not transcribed:
Homepage /api/services, asset-engine /api/v1/services, LiteLLM
/v1/models, and every FastAPI seat's /openapi.json. A copied service
table would be stale within a month and this repo already has a
standing rule against second copies that drift.

Contents verified against the running fleet rather than copied from
existing docs: binaries resolved on PATH, seven endpoints probed live,
the LiteLLM roster counted at 40 models where the old note said ~30.
No credentials are included; the vault and its CLI are pointed at
instead.
2026-09-18 07:35:28 -07:00

825 B

Playwright + headless Chromium

Installed box-wide on nh3-dev. Use for anything needing a real browser engine: true DOM/SVG layout geometry, screenshots, headless rendering, browser-based tests or scraping.

  • System shared-libs installed via apt (playwright install-deps)
  • Browser binaries in shared /opt/ms-playwright (root-owned, world-readable)
  • PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright wired globally (/etc/environment + /etc/profile.d/)

A project needs only the playwright module — npm i playwright. The browser download is skippable and there is no per-project playwright install; it resolves the shared binary.

Add a browser or bump versions:

ssh infra-ops@10.100.10.50 \
  'sudo env PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright npx -y playwright install <browser>'