# What is Shiplight AI?

<div class="view-markdown-wrapper">
<ViewMarkdown />
</div>

### 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](/guides/how-self-healing-works))

## Explore

### Author & Run

| I want to...                      | Go to                                                    |
| --------------------------------- | -------------------------------------------------------- |
| Create YAML or agent-driven tests | [Create Tests](/local/agent-workflow/create-tests)       |
| Run tests locally                 | [Run Locally](/local/run-locally)                        |
| Pick where tests should run       | [Where Tests Run](/local/where-tests-run)                |
| Fix a failing test                | [Fix a Failing Test](/guides/fix-a-failing-test)         |
| Understand self-healing           | [How Self-Healing Works](/guides/how-self-healing-works) |
| Configure CI                      | [CI/CD](/local/ci)                                       |

### Quick Validation

| I want to...                      | Go to              |
| --------------------------------- | ------------------ |
| Verify a UI change in the browser | [Guides](/guides/) |

### Reference

| I want to...                     | Go to                                                      |
| -------------------------------- | ---------------------------------------------------------- |
| Look up YAML test syntax         | [YAML Test Format](/local/yaml-tests/)                     |
| Look up an MCP tool's parameters | [MCP Tool Reference](/local/agent-workflow/tool-reference) |
| Look up a CLI command            | [CLI Reference](/local/cli-reference)                      |