server
AI-assisted website testing with Playwright and Gherkin
Installation
npx @letsrunit/mcp-serverAsk AI about server
Powered by Claude Β· Grounded in docs
I know everything about server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
letsrunit is a browser testing tool that describes what your app should do in plain language rather than code. Tests are written in Gherkin, run by Cucumber.js, and integrate into any CI pipeline as standard files. You can write them by hand, generate them from a live URL, or let your AI coding agent produce them as part of its normal workflow.
Getting Started
Run the init tool inside your project:
npx letsrunit init
This will:
- Install
@letsrunit/clias a local devDependency - Install
@letsrunit/bddand createcucumber.jsif@cucumber/cucumberis detected - Create a
features/directory with an example feature file
Safe to re-run β all steps are idempotent.
CLI
The CLI is installed locally by letsrunit init. Run it via npx letsrunit or yarn letsrunit.
| Command | Description |
|---|---|
letsrunit explore <url> | Open a browser, let the AI explore the site, and optionally save a .feature file |
letsrunit generate <url> | Generate a Gherkin feature from instructions provided on stdin |
letsrunit run <url> <feature> | Execute a .feature file against the given URL |
Options (all commands): -v / --verbose, -s / --silent, -o / --save <path>
MCP Server
The MCP server lets AI coding agents (Claude Code, Cursor, Codex, etc.) launch browsers, run Gherkin steps, take screenshots, and inspect pages directly inside your editor.
Install
Claude Code β add the marketplace once, then install the plugin to get both the MCP server and skill:
/plugin marketplace add letsrunit-hq/agent
/plugin install letsrunit@letsrunit
Other agents β add to your MCP config manually:
{
"mcpServers": {
"letsrunit": {
"command": "npx",
"args": ["-y", "@letsrunit/mcp-server"]
}
}
}
Agent Skill
The letsrunit skill gives your agent built-in knowledge of the Gherkin step library, locator syntax, and test-writing workflow. Requires the MCP server to be configured first.
The skill is included automatically when using the Claude Code plugin above. For other agents run
npx skills add letsrunit-hq/agent
Development
Read the development guide.
