e2e
e2e is an open source end-to-end testing framework
for web and mobile apps. A test mixes agent goals (agent.act) with exact
locator steps and assertions, and runs in a browser or on an iOS simulator,
Android emulator, or phone.
Skills
- e2e: set up e2e in a project, write and fix tests, run them, debug a failed run, drive the running app over the e2e MCP server, explore an app toward a goal, and bug bash a branch with each bug proven by a repro test.
- create-verification-skill: generate a project-local
verify-<app>skill and feature map on top of e2e. Invoke it with/e2e:create-verification-skillin Claude Code or$e2e:create-verification-skillin Codex. It loads only when invoked. - migrate-to-e2e: port a Playwright, Cypress, Selenium, Appium, Detox, Maestro,
or TesterArmy suite to e2e one slice at a time, with the old suite running beside the
new one and a
MIGRATION.mdfile the next session resumes from.
Install
The e2e-inc/e2e repository is a
marketplace for Claude Code, Codex, and Cursor. All three marketplace files
point to plugins/e2e, and installation copies this directory into the
client's cache. Grok Build reads the Claude Code files, and GitHub Copilot
CLI reads the Claude Code marketplace.
Claude Code:
claude plugin marketplace add e2e-inc/e2e
claude plugin install e2e@e2e
Codex:
codex plugin marketplace add e2e-inc/e2e
codex plugin add e2e@e2e
GitHub Copilot CLI:
copilot plugin marketplace add e2e-inc/e2e
copilot plugin install e2e@e2e
Cursor loads plugins from ~/.cursor/plugins/local/. Copy this directory
there, then run Developer: Reload Window:
repo=$(mktemp -d)
git clone --depth 1 https://github.com/e2e-inc/e2e "$repo"
mkdir -p ~/.cursor/plugins/local
rm -rf ~/.cursor/plugins/local/e2e
cp -R "$repo/plugins/e2e" ~/.cursor/plugins/local/
On Teams and Enterprise, local plugins need the admin setting Allow Local
Plugin Imports, or an admin imports e2e-inc/e2e under Team Marketplaces
in the Cursor dashboard.
Devin reads .devin-plugin/plugin.json. In Devin, open Customize →
Plugins → Add plugin → From repository, enter e2e-inc/e2e with the
subdirectory plugins/e2e, then start a new session. With the Devin CLI,
run devin plugins install --local ./plugins/e2e from a clone of this
repository.
Start a new session after installing. The plugin's version follows e2e
releases. Update it with claude plugin marketplace update e2e followed by
claude plugin update e2e@e2e, or in Codex with
codex plugin marketplace upgrade e2e, then start a new session. In
Cursor, run the commands above again.
To try local changes, run the same commands from the monorepo root with
./ in place of e2e-inc/e2e. Claude Code reads a local marketplace
in place, so edits show at the next session start or /reload-plugins. For
a one-session preview, run claude --plugin-dir ./plugins/e2e or
agent --plugin-dir ./plugins/e2e.
The plugin is not listed in any client's public directory.
Requirements
Node.js 24.8 or newer, or 22.22.3 or newer on Node.js 22. In a project that
does not use e2e yet, the skill asks before setting it up. Agent steps need a
model: an AI SDK provider key, or a ChatGPT subscription through
npx e2e login openai.
MCP server
The plugin registers the e2e MCP server as npx -y e2e@<version> mcp
(from .mcp.json, or mcp.json in GitHub Copilot), pinned to the e2e release the plugin version
matches. Claude Code and Codex start it in the session's working directory,
where the server finds the project's config; start the session from the
project directory after installing dependencies. npx runs the project's
installed e2e when its version matches the pin, and downloads the pinned
release otherwise.
Claude Code shows the plugin's server as plugin:e2e:e2e. In a directory with no e2e config, the agent can still
open a session by naming the engine package:
open_session {engine: "@e2e-dev/web", app: {url: "http://localhost:3000"}}.
Writing and running tests through the CLI does not require an MCP connection.
Data
- The e2e CLI sends anonymous usage telemetry (commands, engines, versions,
failure codes; never test content, app content, or credentials) to a
PostHog project run by the e2e maintainers. Turn it off with
E2E_TELEMETRY_DISABLED=1,DO_NOT_TRACK=1, ornpx e2e telemetry disable. See Telemetry. npx e2e feedbacksends a report to the same project. The skill shows the report first and sends it only when you agree.- Agent steps send the redacted screen to the model provider you configure. See Security for what is redacted.
Maintain the package
Edit skill Markdown in the monorepo's skills/ directory, then run
pnpm plugins:sync. Commit the generated copies with the source changes.
pnpm plugins:check, also part of pnpm check and CI, catches drift.
The Codex manifest owns the plugin's metadata. The sync command generates
the Claude and Cursor manifests from it, the root plugin.json that
GitHub Copilot reads (the Agent Plugins
format), and .devin-plugin/plugin.json, the card and MCP server Devin's
marketplace reads, and
copies the root license. It also generates .mcp.json and
Copilot's mcp.json, both pinned to the runner version; a root
plugin.json cannot name MCP servers, so Copilot loses the server without
mcp.json. The skill copies leave out metadata.openclaw, which ClawHub
reads from skills/: the Agent Skills spec takes string metadata values only. Skill UI metadata in
skills/*/agents/openai.yaml and the plugin's assets are maintained here.
Keep every referenced file inside this plugin directory so cached installs
work without the rest of the monorepo. The repo's development .mcp.json
is outside this package.
The initial Codex manifest, icons, and skill UI metadata came from e2e-inc/plugins at 9954005. The shared skill content follows this monorepo's current sources. Docs: https://e2e.com/docs.