Purpose
This is a check-only setup under the plugin contract's carve-out for external prerequisites
setup can only verify (docs/plugin-philosophy.md, "Setup is explicit and repeatable"). The
plugin owns no consumer-project configuration; its one userConfig option, playwright_core, is
set through Claude Code's plugin settings, never written here. Everything else it needs (ffmpeg,
Node, playwright-core and its Chromium) is installed by the operator, and the Python packages are
installed by the plugin's SessionStart hook, so there is nothing an apply could conformingly
write.
Non-interactive: never prompt. Run the probe, print the table, stop.
check (read-only)
${CLAUDE_PLUGIN_ROOT}/scripts/prereq.py owns every probe, its threshold and its remedy text;
the same rows stop render.py and decode.py with exit 2 when a tool is missing. Run it, do not
restate it:
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/pydeps.py run --data-dir "${CLAUDE_PLUGIN_DATA}" -- \
${CLAUDE_PLUGIN_ROOT}/scripts/prereq.py --playwright-core '${user_config.playwright_core}'
It prints the PASS/FAIL/INFO table with one remediation line per FAIL and exits 1 when any row
fails. An unset playwright_core option (empty, or left as the literal placeholder) is skipped;
a set one gets its own row. Report the table as printed. An INFO on numpy or opencv means a
version other than the pin in ${CLAUDE_PLUGIN_ROOT}/requirements.in is installed: scripts run,
but statistics may differ from the shipped pack and regression, so say so.
When the Python packages are not installed, pydeps.py run exits 2 with the repair line instead of
the table: report that line as the one FAIL (the SessionStart hook installs the packages, and a
failed install was reported as a notice at session start), and run
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/prereq.py for the tool rows (it needs only the standard
library; numpy and opencv then read FAIL).
Do not install anything, and do not change the playwright_core option.
Next
/animation:rotoscope
Gotchas
- The Chromium row launches the browser through
capture.mjs --probe, so it takes a few seconds and is the one row that proves playwright-core and its browser resolve together. - A PASS on the Chromium row with an unset option can come from the working directory or a
playwright-cli install on PATH:
capture.mjsowns that lookup order.