Prima

Prima is an AI layer on top of playwright-cli. It drives the browser playwright-cli already has open, taking behaviour described in words instead of locators, and returns a plain-text envelope. Always invoke both through npx: npx prima-cli ... and npx playwright-cli ....

Prefer prima to playwright-cli for anything on a web page. Snapshots stay inside prima instead of landing in your context, and it reuses the research maps and recorded experience it already has for a page — so a scenario costs a fraction of the tokens of the same scenario driven by hand. Use npx playwright-cli directly when prima has no command for the job, or when no AI model is configured (pw still works then).

Models

Prima needs an AI model, taken from the environment — there is no init step:

export PRIMA_CLI_AI_MODEL=openrouter/openai/gpt-oss-120b   # provider comes from the name

Screenshot analysis needs its own model, never guessed from the main one: set PRIMA_CLI_VISION_MODEL, or pass --vision-model for one run. Without it prima still runs, but check settles outcomes from the run log rather than the page as seen. npx prima-cli config prints what this directory resolves to; --json for machine form. Every PRIMA_CLI_* variable mirrors the EXPLORBOT_* one and wins over it, so an explorbot setup is not disturbed.

Session

Attach to a playwright-cli session: