# Momentic ## Docs - [API keys and team settings](https://momentic.ai/docs/account/api-keys-and-team.md): Manage API keys, team members, roles, SSO, and billing in the Momentic dashboard. - [Privacy and security](https://momentic.ai/docs/account/security.md): Momentic's data handling, certifications, and sub-processors. - [Debugging flaky tests](https://momentic.ai/docs/best-practices/debugging-flaky-tests.md): Diagnose and fix tests that flap between pass and fail. - [Writing maintainable tests](https://momentic.ai/docs/best-practices/maintainable-tests.md): Patterns that keep Momentic tests readable, debuggable, and fast to change. - [Test organization](https://momentic.ai/docs/best-practices/test-organization.md): Directory layouts, naming, and labeling patterns that scale past a handful of tests. - [Product updates](https://momentic.ai/docs/changelog.md): New updates and improvements - [CLI reference](https://momentic.ai/docs/cli-reference.md): Pick the right Momentic CLI for web or mobile testing. - [momentic-mobile app](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/app.md): Open the local Momentic editor for authoring mobile tests. - [momentic-mobile assets](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/assets.md): List, upload, download, and delete mobile assets on Momentic. - [momentic-mobile init](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/init.md): Scaffold a new Momentic mobile project in the current directory. - [momentic-mobile install-browsers](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/install-browsers.md): Install browser executables for Android webview automation. - [momentic-mobile install-skills](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/install-skills.md): Install Momentic mobile skill files for coding agents (deprecated). - [momentic-mobile lint](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/lint.md): Validate Momentic simplified format mobile test and module YAML files. - [momentic-mobile list](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/list.md): List local Momentic mobile tests matching a pattern. - [momentic-mobile mcp](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/mcp.md): Run the Momentic mobile MCP server for coding agents. - [momentic-mobile migrate simplified-format](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/migrate.md): Rewrite local mobile tests and modules from legacy YAML to the simplified format. - [momentic-mobile results](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/results.md): Upload, merge, and view local Momentic mobile test results. - [momentic-mobile run](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/run.md): Run Momentic mobile tests locally and optionally upload results. - [momentic-mobile upgrade](https://momentic.ai/docs/cli-reference/momentic-mobile/commands/upgrade.md): Bring an existing Momentic mobile project current with the latest recommended settings and file format. - [momentic-mobile CLI](https://momentic.ai/docs/cli-reference/momentic-mobile/overview.md): Drive Momentic iOS and Android tests locally and in CI. - [momentic ai](https://momentic.ai/docs/cli-reference/momentic/commands/ai.md): AI-assisted classification and authoring for Momentic runs. - [momentic app](https://momentic.ai/docs/cli-reference/momentic/commands/app.md): Open the local Momentic web editor for authoring tests. - [momentic apply](https://momentic.ai/docs/cli-reference/momentic/commands/apply.md): Apply patch changes to local Momentic tests. - [momentic check](https://momentic.ai/docs/cli-reference/momentic/commands/check.md): Validate Momentic tests, modules, and config files. - [momentic import](https://momentic.ai/docs/cli-reference/momentic/commands/import.md): Import tests, modules, and environments from the Momentic dashboard. - [momentic init](https://momentic.ai/docs/cli-reference/momentic/commands/init.md): Scaffold a new Momentic project in the current directory. - [momentic install-browsers](https://momentic.ai/docs/cli-reference/momentic/commands/install-browsers.md): Install browser executables for Momentic web tests. - [momentic install-skills](https://momentic.ai/docs/cli-reference/momentic/commands/install-skills.md): Install Momentic skill files for coding agents (deprecated). - [momentic lint](https://momentic.ai/docs/cli-reference/momentic/commands/lint.md): Validate Momentic simplified format test and module YAML files. - [momentic list](https://momentic.ai/docs/cli-reference/momentic/commands/list.md): List local Momentic tests matching a pattern or label. - [momentic mcp](https://momentic.ai/docs/cli-reference/momentic/commands/mcp.md): Run the Momentic MCP server for coding agents. - [momentic migrate simplified-format](https://momentic.ai/docs/cli-reference/momentic/commands/migrate.md): Rewrite local web tests and modules from legacy YAML to the simplified format. - [momentic quarantine](https://momentic.ai/docs/cli-reference/momentic/commands/quarantine.md): Quarantine or unquarantine tests from the CLI. - [momentic queue](https://momentic.ai/docs/cli-reference/momentic/commands/queue.md): Queue dashboard-hosted tests and suites on Momentic infrastructure (deprecated). - [momentic results](https://momentic.ai/docs/cli-reference/momentic/commands/results.md): Upload, merge, and view local Momentic test results. - [momentic run](https://momentic.ai/docs/cli-reference/momentic/commands/run.md): Run Momentic web tests locally and optionally upload results. - [momentic upgrade](https://momentic.ai/docs/cli-reference/momentic/commands/upgrade.md): Bring an existing Momentic project current with the latest recommended settings and file format. - [momentic CLI](https://momentic.ai/docs/cli-reference/momentic/overview.md): Drive Momentic web tests locally and in CI. - [Appium](https://momentic.ai/docs/comparisons/appium.md): How Momentic's managed step cache, AI primitives, and YAML authoring compare against Appium for mobile testing. - [Maestro](https://momentic.ai/docs/comparisons/maestro.md): How Momentic's managed step cache, AI assertions, recovery, and quarantine compare against Maestro for mobile testing. - [Playwright MCP](https://momentic.ai/docs/comparisons/playwright-mcp.md): How Momentic's preview-then-commit MCP loop and step cache compare against Microsoft's interact-then-generate Playwright MCP server. - [Stagehand](https://momentic.ai/docs/comparisons/stagehand.md): How Momentic's multi-modal step cache, AI primitives, and managed runner compare against Stagehand and Browserbase. - [Advanced configuration](https://momentic.ai/docs/configuration/advanced.md): Reference for the `advanced` block in `momentic.config.yaml`. Niche settings for testing edge cases. - [AI configuration](https://momentic.ai/docs/configuration/ai.md): Reference for the `ai` block in `momentic.config.yaml`. Per-agent version controls and local AI feature toggles. - [Browser configuration](https://momentic.ai/docs/configuration/browser.md): Reference for the `browser` block in `momentic.config.yaml`. Controls defaults for all browser-based tests in a project. - [Environment variables](https://momentic.ai/docs/configuration/environment-variables.md): How Momentic reads environment variables and secrets at runtime, in order of precedence. - [Environments](https://momentic.ai/docs/configuration/environments.md): Reference for the `environments` array in `momentic.config.yaml`. Each environment defines a base URL and a set of variables (including secrets) available to tests. - [Mobile configuration](https://momentic.ai/docs/configuration/mobile.md): Reference for the `emulator` block in `momentic.config.yaml`. Controls remote-hosted mobile emulators spun up by `momentic-mobile`. - [momentic.config.yaml](https://momentic.ai/docs/configuration/momentic-config.md): Index for `momentic.config.yaml`. Project-level options live here; large blocks like `browser`, `ai`, and `emulator` have their own reference pages. - [Test file globs](https://momentic.ai/docs/configuration/test-globs.md): Glob syntax used by `include` and `exclude` in momentic.config.yaml. - [Workspaces](https://momentic.ai/docs/configuration/workspace.md): Group multiple Momentic projects under one repository with a workspace file. - [Agentic testing](https://momentic.ai/docs/core-concepts/agentic-testing.md): Use **AI action** steps to test dynamic scenarios and high-level goals without hard-coding every interaction. - [Authentication](https://momentic.ai/docs/core-concepts/authentication.md): Strategies for authenticating into your app from a Momentic test without breaking on SSO or 2FA. - [Editor validation](https://momentic.ai/docs/core-concepts/editor-validation.md): Add Momentic's JSON Schemas to your editor for autocomplete and inline validation while you hand-edit test and module YAML. - [Finding elements](https://momentic.ai/docs/core-concepts/finding-elements.md): How to describe elements so Momentic's AI reliably finds them. - [Modules](https://momentic.ai/docs/core-concepts/modules.md): Extract reusable sequences of steps, parameterize them, and share across tests. - [Test format](https://momentic.ai/docs/core-concepts/test-format.md): How Momentic tests and modules are written on disk. One simplified YAML format for web and mobile, with single-key command aliases, natural-language targets, modules, and conditionals. - [Variables](https://momentic.ai/docs/core-concepts/variables.md): Store and reuse data across steps using the global `env` object and templating syntax. - [Writing assertions](https://momentic.ai/docs/core-concepts/writing-assertions.md): How to write **AI check** assertions that pass reliably and fail for the right reasons. - [Cloud deprecation](https://momentic.ai/docs/get-started/cloud-deprecation.md): Authoring and running tests in the Momentic cloud is deprecated. Run `npx momentic import` to pull your tests into your repo and own them with the CLI. - [How Momentic works](https://momentic.ai/docs/get-started/how-momentic-works.md): The agent loop, step cache, auto-heal, and how Momentic tests flow from prompt to result. - [Simplified format](https://momentic.ai/docs/get-started/migrate-to-simplified-format.md): Move existing tests and modules from legacy YAML to Momentic's simplified format, on web and mobile. - [Overview](https://momentic.ai/docs/guides.md): Task-oriented recipes for the most common Momentic workflows, like auth, file uploads, network assertions, and data-driven runs. - [Cache authenticated sessions](https://momentic.ai/docs/guides/auth/cached-session.md): Wrap your login flow in an auth module so parallel tests only authenticate once. - [Log in with email verification links](https://momentic.ai/docs/guides/auth/email-link.md): Extract a magic login link from an email and navigate to it. - [Log in with email OTP codes](https://momentic.ai/docs/guides/auth/email-otp.md): Fetch a one-time passcode from a Momentic-provisioned inbox and type it into your app. - [Log in with OTPAuth (TOTP)](https://momentic.ai/docs/guides/auth/otpauth.md): Generate authenticator-app 2FA codes inside a **JavaScript** step using the `otpauth` library. - [Authentication strategies](https://momentic.ai/docs/guides/auth/overview.md): How to authenticate in your tests and reuse the session across runs. Compares live login, authSave/authLoad state files, and cached auth modules, with trade-offs and a recommended order. - [Log in with SMS OTP codes](https://momentic.ai/docs/guides/auth/sms-otp.md): Fetch a one-time passcode from a Momentic-provisioned phone number and type it into your app. - [Test Vercel protected preview environments](https://momentic.ai/docs/guides/auth/vercel-previews.md): Bypass Vercel's authentication wall using a protection bypass secret. - [Auto-heal failing tests in CI](https://momentic.ai/docs/guides/auto-heal/in-ci.md): Run the healing agent on every pull request to repair failing tests and open the fix as a PR. - [Run tests against multiple inputs](https://momentic.ai/docs/guides/data-driven-tests/parametrized-runs.md): Parameterize a test and drive it from a CSV to run the same flow against different data. - [Download files](https://momentic.ai/docs/guides/page-interactions/download-files.md): Wait for a file download triggered by a **Click** step and optionally save the URL for later use. - [Select options from a dropdown](https://momentic.ai/docs/guides/page-interactions/dropdowns.md): Use **Select** for native `` dropdown. - [switchTab](https://momentic.ai/docs/reference/commands/switch-tab.md): Switch the active tab by index, URL substring, or URL regex. - [type](https://momentic.ai/docs/reference/commands/type.md): Type text into an input, optionally clearing and submitting. - [visualDiff](https://momentic.ai/docs/reference/commands/visual-diff.md): Compare a viewport or element screenshot against a golden file. - [wait](https://momentic.ai/docs/reference/commands/wait.md): Pause execution for a fixed duration in milliseconds. - [waitForUrl](https://momentic.ai/docs/reference/commands/wait-for-url.md): Wait until the page URL matches a substring, glob, regex, or domain. - [waitForUrlNotToMatch](https://momentic.ai/docs/reference/commands/wait-for-url-not-to-match.md): Wait until the page URL stops matching a substring, glob, regex, or domain. - [act](https://momentic.ai/docs/reference/mobile-commands/act.md): Let the AI agent accomplish a goal autonomously. - [adb](https://momentic.ai/docs/reference/mobile-commands/adb.md): Run an adb command against the device. - [addFile](https://momentic.ai/docs/reference/mobile-commands/add-file.md): Push a file onto the device. - [appium](https://momentic.ai/docs/reference/mobile-commands/appium.md): Execute an Appium script against the device. - [assert](https://momentic.ai/docs/reference/mobile-commands/assert.md): Assert a condition about the screen using the AI agent. - [checkElement](https://momentic.ai/docs/reference/mobile-commands/check-element.md): Element-level assertion family for the element itself. - [checkElementAttribute](https://momentic.ai/docs/reference/mobile-commands/check-element-attribute.md): Element-level assertion family for an attribute on the element. - [checkElementContent](https://momentic.ai/docs/reference/mobile-commands/check-element-content.md): Element-level assertion family for the element's text content. - [checkElementName](https://momentic.ai/docs/reference/mobile-commands/check-element-name.md): Element-level assertion family for the element's type name. - [checkElementStyle](https://momentic.ai/docs/reference/mobile-commands/check-element-style.md): Element-level assertion family for a computed style on the element. - [checkScreenContains](https://momentic.ai/docs/reference/mobile-commands/check-screen-contains.md): Assert that text is present anywhere on the screen. - [checkScreenDoesNotContain](https://momentic.ai/docs/reference/mobile-commands/check-screen-does-not-contain.md): Assert that text is absent from the screen. - [debugState](https://momentic.ai/docs/reference/mobile-commands/debug-state.md): Capture device state for debugging. - [dragAndDrop](https://momentic.ai/docs/reference/mobile-commands/drag-and-drop.md): Drag one element onto another. - [extract](https://momentic.ai/docs/reference/mobile-commands/extract.md): Extract structured data from the screen. - [if](https://momentic.ai/docs/reference/mobile-commands/if.md): Run steps conditionally based on an assertion. - [Mobile commands](https://momentic.ai/docs/reference/mobile-commands/index.md): The mobile command set for Momentic iOS and Android tests, covering taps, swipes, device buttons, and app lifecycle. - [installApp](https://momentic.ai/docs/reference/mobile-commands/install-app.md): Install an app from a file path. - [javascript](https://momentic.ai/docs/reference/mobile-commands/javascript.md): Run a JavaScript snippet during the test. - [killApp](https://momentic.ai/docs/reference/mobile-commands/kill-app.md): Force-stop the app under test. - [module](https://momentic.ai/docs/reference/mobile-commands/module.md): Invoke a reusable module file. - [openApp](https://momentic.ai/docs/reference/mobile-commands/open-app.md): Launch an app by its package or bundle identifier. - [openNotifications](https://momentic.ai/docs/reference/mobile-commands/open-notifications.md): Open the Android notification drawer. - [press](https://momentic.ai/docs/reference/mobile-commands/press.md): Press a physical device button. - [pressKey](https://momentic.ai/docs/reference/mobile-commands/press-key.md): Press a software keyboard key. - [request](https://momentic.ai/docs/reference/mobile-commands/request.md): Issue an HTTP request from the test. - [rotate](https://momentic.ai/docs/reference/mobile-commands/rotate.md): Rotate the device orientation. - [scrollTo](https://momentic.ai/docs/reference/mobile-commands/scroll-to.md): Scroll until a target element is on screen. - [swipe](https://momentic.ai/docs/reference/mobile-commands/swipe.md): Swipe in a direction, optionally within a scroll container. - [tap](https://momentic.ai/docs/reference/mobile-commands/tap.md): Tap an element identified by description or percent-pair coordinates. - [toggleSettings](https://momentic.ai/docs/reference/mobile-commands/toggle-settings.md): Toggle an Android system setting. - [type](https://momentic.ai/docs/reference/mobile-commands/type.md): Type text, optionally into a specific field. - [uninstallApp](https://momentic.ai/docs/reference/mobile-commands/uninstall-app.md): Uninstall an app by its package name. - [wait](https://momentic.ai/docs/reference/mobile-commands/wait.md): Pause execution for a fixed duration in milliseconds. - [Auto-healing](https://momentic.ai/docs/reliability/auto-heal.md): Momentic keeps tests green by re-resolving locators and waiting for page stability before every action. - [Results classification](https://momentic.ai/docs/reliability/failure-analysis.md): AI-generated classification and triage actions for failed CLI runs, surfaced in the dashboard and CLI. - [Failure recovery](https://momentic.ai/docs/reliability/failure-recovery.md): Auto-recovers from transient test failures like slow loads, cookie banners, and race conditions. - [Global locator redirect](https://momentic.ai/docs/reliability/global-locator-redirect.md): Bridges the accessibility tree and actual interactive elements so Momentic can click what the user sees, not a hidden backing element. - [Knowledge base](https://momentic.ai/docs/reliability/knowledge-base.md): Teach Momentic about your product (terminology, agent rules, and flows) so every AI-assisted step behaves consistently across runs. - [Memory](https://momentic.ai/docs/reliability/memory.md): Momentic seeds AI decisions with traces from past successful runs so the agent stays consistent across executions. - [Quarantine](https://momentic.ai/docs/reliability/quarantine.md): Skip flaky tests without failing pipelines, manually or via automated rules. - [Step caching](https://momentic.ai/docs/reliability/step-cache.md): Momentic caches locator data from successful runs so repeat runs execute in milliseconds without AI calls. - [Azure DevOps](https://momentic.ai/docs/running-tests/ci/azure-devops.md): Run Momentic tests from Azure Pipelines, with sharding and secrets. - [Buildkite](https://momentic.ai/docs/running-tests/ci/buildkite.md): Run Momentic tests from Buildkite, with sharding and secrets. - [CircleCI](https://momentic.ai/docs/running-tests/ci/circleci.md): Run Momentic tests from CircleCI, with sharding and secrets. - [Custom setups](https://momentic.ai/docs/running-tests/ci/custom-setups.md): Make Momentic behave correctly when running on CI providers without a dedicated guide. - [GitHub Actions](https://momentic.ai/docs/running-tests/ci/github-actions.md): Run Momentic tests from GitHub Actions, with sharding and secrets. - [GitLab CI](https://momentic.ai/docs/running-tests/ci/gitlab-ci.md): Run Momentic tests from GitLab CI, with sharding and secrets. - [Jenkins](https://momentic.ai/docs/running-tests/ci/jenkins.md): Run Momentic tests from a Jenkins pipeline. - [Travis CI](https://momentic.ai/docs/running-tests/ci/travis-ci.md): Run Momentic tests from Travis CI. - [Performance](https://momentic.ai/docs/running-tests/performance.md): Runtime characteristics, step-by-step timings, how to speed up large suites with parallelism and sharding, and Momentic vs. Playwright benchmarks. - [Results and reporting](https://momentic.ai/docs/running-tests/results.md): View test results in the dashboard, generate JUnit, Allure, or Playwright JSON reports, and surface failures in CI. - [Running locally](https://momentic.ai/docs/running-tests/running-locally.md): Run Momentic tests on your own machine for fast feedback during development.