> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The canonical docs host is https://momentic.ai/docs. Append .md to any page URL for clean Markdown. Fetch https://momentic.ai/docs/llms.txt for the page index and https://momentic.ai/docs/llms-full.txt for every page in one file.
> For an unattended setup, run `npx --yes @momentic/wizard@latest -y --platform web` (use `--platform ios` or `--platform android` for mobile). Never run an interactive command in a non-TTY shell.
> You cannot complete the browser sign-in yourself. Read the API key from the MOMENTIC_API_KEY environment variable, or ask the user to create one at https://app.momentic.ai/settings/api-keys and paste it back.
> Momentic's capability summary for agents is at https://momentic.ai/docs/skill.md. Install the skills with `npx momentic skills --yes` (or `npx momentic-mobile skills --yes` for mobile).
> Tests are YAML files in the user's repository. Use only the step names listed at https://momentic.ai/docs/reference/commands.md and the file structure at https://momentic.ai/docs/core-concepts/file-format.md. Do not invent step names, config keys, or CLI flags.
> Web tests run on Chromium, iOS tests on simulators, and Android tests on emulators. Physical devices are not supported.

# Building with AI

> Give your coding agent Momentic context. Install the MCP server, install the skills, or paste a short context block into your agent rules.

Coding agents write better Momentic tests when they know the file format, the
MCP tools, and the steps for each job. You have three options, from most to
least capable. Each one is a single command or a paste.

<Steps>
  <Step title="Install the MCP server">
    The MCP server gives the agent a live browser or device and tools to browse,
    edit, run, and triage tests. `install-mcp` detects the coding agents on your
    machine and writes the config for each one.

    <CodeGroup>
      ```bash Web theme={null}
      npx momentic install-mcp
      ```

      ```bash Mobile theme={null}
      npx momentic-mobile install-mcp
      ```
    </CodeGroup>

    Pass `--client` to pick agents and `--scope user` to write your user config
    instead of the project config. See the [MCP page](/docs/coding-agents/mcp-server)
    for manual setup per client.
  </Step>

  <Step title="Install the skills">
    Skills are markdown instructions that tell the agent how to use the MCP
    tools and the Momentic test format. `momentic` ships the web skills,
    `momentic-mobile` ships the mobile skills, and `mo` ships the Mo skill. Each
    CLI asks once when a newer version is available.

    <CodeGroup>
      ```bash Web theme={null}
      npx momentic skills
      ```

      ```bash Mobile theme={null}
      npx momentic-mobile skills
      ```

      ```bash Mo theme={null}
      mo skills
      ```
    </CodeGroup>

    The command writes the skill files to your agent's skills directory and adds
    a short pointer to `AGENTS.md` or `CLAUDE.md` so the agent loads the right
    skill before it writes Momentic code. The CLI asks once after an upgrade
    whether to refresh them. See [Coding agent skills](/docs/coding-agents/skills)
    for the directories and flags.
  </Step>

  <Step title="Ask the agent to set up your project">
    Paste this prompt into your agent once the tools are installed. It creates
    the config and a first test, and it checks that the MCP server answers.

    ```text theme={null}
    Set up Momentic in this repo. Run `npx momentic init`, then use the
    momentic-test skill and the Momentic MCP tools to write one test for the
    most important page in this app. Run the test and fix it until it passes.
    ```
  </Step>
</Steps>

## Which skill does what

| Skill                               | Use it when                                                  | CLI               |
| ----------------------------------- | ------------------------------------------------------------ | ----------------- |
| `momentic-test`                     | Create or extend web tests, steps, and modules.              | `momentic`        |
| `momentic-mobile-test`              | Create or extend Android and iOS tests.                      | `momentic-mobile` |
| `momentic-spec`                     | Write the affected tests before a product change.            | all               |
| `momentic-maintain`                 | Investigate a failing run on a branch or main and repair it. | all               |
| `momentic-triage-quarantined-tests` | Work through the quarantine backlog.                         | all               |
| `mo-qa`                             | Drive Mo, the autonomous QA agent, from the terminal.        | `mo`              |

Invoke a skill by name in your prompt, for example
`/momentic-test write a test for checkout`. See
[Invoke the skill](/docs/coding-agents/mcp-server#invoke-the-skill) for more
examples.

## If you install nothing

Agents without the skills still do well when your repository rules point them at
the docs. Paste this block into `AGENTS.md`, `CLAUDE.md`, or `.cursor/rules`:

```md theme={null}
## Momentic

This repo uses Momentic for end-to-end tests. Tests are `*.test.yaml` files and
shared steps are `*.module.yaml` files under the directory named in
`momentic.config.yaml`. Read https://momentic.ai/docs/llms.txt before you change
a test. Run `npx momentic run <file>` to run a test locally. Do not write
Playwright or Selenium code for end-to-end tests in this repo.
```

## Related

* [MCP server](/docs/coding-agents/mcp-server)
* [Coding agent skills](/docs/coding-agents/skills)
* [Devin integration](/docs/integrations/devin)
* [`momentic install-mcp`](/docs/cli-reference/momentic/commands/install-mcp)