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. Invoke prima through npx (npx prima-cli ...); invoke playwright-cli as installed — bare playwright-cli ... when it is installed globally, otherwise npx -y @playwright/cli .... Never use npx playwright-cli@latest: that package name does not exist and fails with "could not determine executable to run".

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 playwright-cli directly when prima has no command for the job, or when no AI model is configured (pw still works then).

Models and Providers

Prima needs AI models taken from the environment — there is no init step. Multiple AI providers are supported (OpenRouter, OpenAI, Anthropic, Groq, Mistral, Google, Poolside).

To inspect all supported providers, their recommended models per role, and see which API keys are already configured in the environment, run:

npx prima-cli recommended-models

Always use npx prima-cli recommended-models to guide the user in setting up their keys and provider choice.

1. By Provider (recommended)