What is Shiplight AI?

View as Markdown

Agents author tests. Humans stay in control.

Shiplight gives your coding agent eyes and hands in a real browser: your agent becomes the primary author and maintainer of your YAML E2E tests, while humans stay in control by reviewing readable tests and hand-tuning complex flows when needed. It works with Claude Code, Cursor, Codex, and any MCP-compatible agent.

How It Works

1. Install MCP and Skills so your coding agent can launch a real browser, inspect your app, and run Shiplight workflows.
2. Verify UI changes by asking the agent to exercise the feature in a real browser.
3. Author and maintain YAML E2E tests from the same browser session: natural language steps, readable like a spec, kept in your repo alongside application code.
4. Hand-tune locally when a flow needs human judgment, using screenshots, traces, and the visual debugger.
5. Run in CI with any supported CI provider.
6. Manage CI test results in Shiplight.
7. Monitor and maintain CI tests with your coding agent.

Why This Workflow

• Agent-authored — coding agents do the primary test creation and maintenance work
• Human-controlled — YAML is easy to read like a spec, and the debugger lets you hand-tune complex UI cases
• Repo-native — YAML E2E tests are versioned with your code and run from your project
• CI-ready — local tests run the same way with any supported CI provider
• Debuggable — failures include browser evidence, traces, and step-level context
• Self-healing — locators adapt when your UI markup changes, so tests keep passing without manual upkeep (how it works)

Explore

Author & Run

I want to...	Go to
Create YAML or agent-driven tests	Create Tests
Run tests locally	Run Locally
Pick where tests should run	Where Tests Run
Fix a failing test	Fix a Failing Test
Understand self-healing	How Self-Healing Works
Configure CI	CI/CD

Quick Validation

I want to...	Go to
Verify a UI change in the browser	Guides

Reference

I want to...	Go to
Look up YAML test syntax	YAML Test Format
Look up an MCP tool's parameters	MCP Tool Reference
Look up a CLI command	CLI Reference