https://github.com/letsrunit-hq/letsrunit
AI-assisted website testing with Playwright and Gherkin
https://github.com/letsrunit-hq/letsrunit
ai cucumber gherkin playwright testing
Last synced: about 1 month ago
JSON representation
AI-assisted website testing with Playwright and Gherkin
- Host: GitHub
- URL: https://github.com/letsrunit-hq/letsrunit
- Owner: letsrunit-hq
- License: mit
- Created: 2025-10-14T15:41:00.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-05-19T22:54:55.000Z (about 1 month ago)
- Last Synced: 2026-05-20T00:51:25.829Z (about 1 month ago)
- Topics: ai, cucumber, gherkin, playwright, testing
- Language: TypeScript
- Homepage: https://letsrunit.ai
- Size: 111 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
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:
```bash
npx letsrunit init
```
This will:
- Install `@letsrunit/cli` as a local devDependency
- Install `@letsrunit/bdd` and create `cucumber.js` if `@cucumber/cucumber` is 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 ` | Open a browser, let the AI explore the site, and optionally save a `.feature` file |
| `letsrunit generate ` | Generate a Gherkin feature from instructions provided on stdin |
| `letsrunit run ` | Execute a `.feature` file against the given URL |
**Options** (all commands): `-v` / `--verbose`, `-s` / `--silent`, `-o` / `--save `
## 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:
```json
{
"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](DEVELOPMENT.md).