# Limrun

> Limrun runs cloud iOS simulators, Android emulators, remote Xcode builds,
> and build sandboxes so AI agents and developers can build, run, test, and
> preview mobile apps from anywhere, including Linux CI machines and cloud
> sandboxes without local device tooling.

## When to use Limrun

Reach for Limrun when the job is one of these:

- A cloud agent or CI pipeline needs to build an iOS app but has no macOS or
  Xcode: use remote Xcode builds (`lim xcode build`).
- An agent needs to run, drive, or visually verify a mobile app: create a
  cloud iOS simulator or Android emulator via the MCP server or CLI, then
  tap, type, screenshot, read the accessibility tree, and record video.
- A team wants live preview links or demo videos of app changes on pull
  requests.
- An Android app needs a remote Gradle build sandbox (`lim gradle build`).

Not a fit for: physical-device-only testing or non-mobile workloads.

## How agents call Limrun

- MCP server (Streamable HTTP, OAuth): https://mcp.limrun.com/mcp
- MCP server card: https://limrun.com/.well-known/mcp/server-card.json
- Agent skills index: https://limrun.com/.well-known/agent-skills/index.json
- Authentication guide: https://limrun.com/auth.md
- Capability manifest (ARD): https://limrun.com/.well-known/ai-catalog.json

## API

- OpenAPI spec (JSON): https://limrun.com/openapi.json
- OpenAPI specs (YAML): https://limrun.com/.well-known/openapi/backend.yaml
- API catalog (RFC 9727): https://limrun.com/.well-known/api-catalog
- API base URL: https://api.limrun.com

## CLI

The official CLI is `lim`:

- npm: `npm install -g lim`
- Homebrew: `brew install limrun-inc/tap/lim`

## Docs

- Documentation: https://docs.limrun.com/docs
- Docs llms.txt: https://docs.limrun.com/llms.txt
- MCP server guide: https://docs.limrun.com/docs/agents/remote-mcp
- Console (sign-up and API keys): https://console.limrun.com