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

22 lines
825 B
Markdown

# 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:
```sh
ssh infra-ops@10.100.10.50 \
'sudo env PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright npx -y playwright install <browser>'
```