Skip to main content

Claude Plugin

The Testery Claude Plugin turns Claude Code into a hands-on Testery teammate. It adds a full set of slash commands and skills that let Claude drive the Testery platform — create test runs, monitor them, manage environments and schedules, upload artifacts — and scaffold or author playwright-bdd tests, all from natural-language conversation.

info

Looking for read-only, conversational access to your Testery data instead? See the Testery MCP Server. The plugin and the MCP server complement each other — the plugin runs the Testery CLI for write operations, and the MCP server is great for inspection.

tip

Using GitHub Copilot? The same plugin works in the Copilot CLI and VS Code. See GitHub Copilot.

Prerequisites​

Install​

From inside a Claude Code session, add the Testery marketplace and install the plugin:

/plugin marketplace add testery/testery-skills
/plugin install testery@testery

Claude Code clones the repo, registers the marketplace, and installs the plugin. Every /testery-* and /bdd-* command and skill becomes available immediately.

Install from a local clone​

If you have already cloned the plugin repository:

/plugin marketplace add /absolute/path/to/testery-claude-plugin
/plugin install testery@testery

Update or uninstall​

/plugin update testery@testery
/plugin uninstall testery@testery
/plugin marketplace remove testery

Quickstart​

After installing the plugin, run these two commands to authenticate and wire up a project:

/testery-onboard # sign up or log in on testery.io, persist your API key
/testery-init # scaffold playwright-bdd + register the project on Testery

/testery-onboard opens the Testery signup/login page, walks you through generating an API key, then saves it to ~/.testery/credentials and your shell profile so it persists across sessions. /testery-init scaffolds a playwright-bdd project, runs a local smoke test, registers the project on Testery, and optionally fires your first cloud run.

Prefer to set the token yourself? Export it before starting Claude Code:

export TESTERY_TOKEN=<your-token> # bash / zsh
$env:TESTERY_TOKEN = '<your-token>' # PowerShell

What you can do​

Once installed, just talk to Claude in natural language — it picks the right skill automatically. For example:

  • "Run my tests on Testery against the staging environment and watch them"
  • "What test runs are currently active?"
  • "Show me the results of the last run"
  • "Register a new qa environment"
  • "Schedule the smoke suite to run nightly at 2am"
  • "Add a scenario that checks the login page rejects a bad password"

Slash commands​

You can also invoke any capability explicitly with a slash command.

Testery platform​

CommandWhat it does
/testery-onboardStart here. Sign up / log in, capture your API key, persist it
/testery-initScaffold playwright-bdd in this project and wire it to Testery
/testery-create-test-runSubmit a Git-based test run
/testery-monitor-test-runFollow a run to completion
/testery-cancel-test-runCancel a running test run
/testery-list-active-test-runsShow in-flight runs
/testery-report-test-runOutput per-test results
/testery-upload-artifactsUpload a local file/dir as a build
/testery-add-fileAttach a file to a test run
/testery-register-environmentCreate a new environment
/testery-update-environmentUpdate an existing environment
/testery-deregister-environmentDelete an environment
/testery-list-environmentsList environments
/testery-upload-environment-fileUpload a file to an environment
/testery-create-scheduleCreate cron / on-deploy / follow schedules
/testery-delete-scheduleRemove a schedule
/testery-create-deployNotify Testery of a deploy
/testery-create-alertSet up an alert
/testery-run-test-planExecute a saved test plan
/testery-load-usersBulk-load users
/testery-verify-tokenAuth health check
/testery-run-playwright-bdd-localRun playwright-bdd tests on this machine
/testery-run-playwright-bdd-on-testeryRun playwright-bdd tests on Testery (local build or remote Git)

Playwright-BDD authoring​

CommandWhat it does
/bdd-add-scenarioAdd a scenario, implement step definitions, drive the red→green loop
/bdd-testRun the playwright-bdd suite (or a single scenario by name)
/bdd-implement-codeImplement app code to make a failing scenario pass
/bdd-view-reportOpen the Playwright HTML report in a browser

How it works​

Each slash command delegates to a matching skill, so the documented behavior lives in one place. The testery-* skills wrap the Testery CLI for write operations — creating runs, uploading artifacts, managing schedules, environments, and deploys. The testery-playwright-bdd-* skills help you author and run playwright-bdd tests and are modeled on a project shaped like the Testery example web app: tests/features/, tests/steps/, a playwright.config.ts that calls defineBddConfig, and a test:e2e script that runs bddgen && playwright test.

Troubleshooting​

testery command not found

  • Install the CLI with pip install testery, or re-run /testery-onboard.

Authentication failures

  • Run /testery-verify-token to confirm your token is valid.
  • Re-run /testery-onboard to regenerate and persist a new API key.

Commands not appearing

  • Confirm the plugin is installed with /plugin, then reinstall with /plugin install testery@testery.

Learn more​