# Momentic agent instructions

> AI end-to-end testing for web and mobile. Write tests in plain English; Momentic builds, runs, and maintains them as your product changes.

Momentic is an AI end-to-end testing platform for web, iOS, and Android. This file tells agents when to use it and where the machine-readable resources are.

## When to use Momentic

Use Momentic for:

- End-to-end web, iOS, and Android regression and smoke suites in CI.
- Authoring tests from a code diff with the explore agent.
- Auto-healing flaky locators as the UI changes.
- Triaging failing test runs.

Agents call Momentic with:

- `npx momentic init` to create a project.
- `npx momentic run` to run tests.
- `npx momentic mcp --config /absolute/path/to/momentic.config.yaml` for editor agents.
- `npx momentic-mobile mcp` for mobile editor agents.

Do not use Momentic for:

- Unit tests.
- Load testing.
- Backend-only assertions that do not exercise a UI.

## Developer resources

- [Developer resources](https://momentic.ai/developers): Momentic documentation, CLIs, MCP, CI, and machine-readable files.
- [Documentation](https://momentic.ai/docs): Product documentation.
- [Docs index for agents](https://momentic.ai/docs/llms.txt): Machine-readable documentation index.
- [Blog index for agents](https://momentic.ai/blog/llms.txt): Dated machine-readable index of blog posts.
- [CLI reference](https://momentic.ai/docs/cli-reference): CLI commands and options.
- [momentic on npm](https://www.npmjs.com/package/momentic): Web CLI package.
- [momentic-mobile on npm](https://www.npmjs.com/package/momentic-mobile): Mobile CLI package.
- [MCP server for coding agents](https://momentic.ai/docs/coding-agents/mcp-server): Run the local stdio MCP server.
- [API keys and team settings](https://momentic.ai/docs/account/api-keys-and-team): Manage API keys and team settings.
- [Machine-readable files](https://momentic.ai/developers): Links to the site machine-readable files.
- [Agent Skills index](https://momentic.ai/.well-known/agent-skills/index.json): Discovery index for Momentic Agent Skills.
- [Agent instructions](https://momentic.ai/agents.md): When to use Momentic, plus every machine-readable index.

## Agent Skills

Use the [Momentic Agent Skills](https://github.com/momentic-ai/skills) and the [Agent Skills index](https://momentic.ai/.well-known/agent-skills/index.json).

## Machine-readable files

- https://momentic.ai/llms.txt
- https://momentic.ai/llms-full.txt
- https://momentic.ai/sitemap.xml
- https://momentic.ai/.well-known/ai-catalog.json
- https://momentic.ai/.well-known/agent-skills/index.json
- https://momentic.ai/server.json
