Skip to main content
Momentic supports local and remote iOS simulators. Real devices are not supported. Local simulators require macOS; remote simulators run from any host.
Using an AI coding tool? Copy the following prompt to set up the Momentic skills and MCP server so agents can author and run mobile tests directly from your editor.

Set up the Momentic mobile CLI, skills, and MCP server for an iOS project.

CursorOpen in Cursor

​
1. Prerequisites

  • Node.js 20.19.0+, 22.12.0+, or 24.0.0+
  • A build of your app (see iOS app setup)
  • For local simulators only: macOS, Xcode, Xcode Command Line Tools, and idb
  • A Momentic account, sign up to generate an API key
node -v  # v20.19.0 or higher

​
2. Install

npm install --save-dev momentic-mobile@latest

​
3. Authenticate

Create an API key in the dashboard, then export it: 
export MOMENTIC_API_KEY=your-api-key-here

​
4. Initialize

npx momentic-mobile init

​
5. Build your app

In Xcode, select Product, then Build For, then Testing. This produces a .app bundle that Momentic can install on a simulator. Full instructions are in iOS app setup.

​
6. Upload your build (remote simulators)

Remote simulators are managed by Momentic, no local Xcode needed once your build is uploaded. 
npx momentic-mobile assets upload ./path/to/YourApp.app \
  --channel dev \
  --tag 1.0.0
Prefer local simulators? See iOS simulators for the LOCAL_IOS_DEVICE_TYPE / LOCAL_IOS_APP_PATH setup.

​
7. Write and run your first test

Open the local editor: 
npx momentic-mobile app
Create a test, pick the dev channel and 1.0.0 tag, and author a single natural-language step. Run from the editor, then run from the CLI: 
npx momentic-mobile run example-test

​
8. Verify

  • Check example-test.test.yaml exists in your project root
  • Open the dashboard and check Runs for the result

​
9. Next steps

iOS app setup

Xcode build, .app bundling, required signing

Simulators

Local vs. remote simulators and device types

CI/CD

Run mobile tests on every pull request
Need a full working example? Clone momentic-ai/examples.