Revyl

Proactive Reliability for Mobile Apps

---

Revyl is an AI-powered testing platform for mobile apps. Define tests in natural language, run them on cloud devices, and catch bugs before your users do. It works with iOS and Android, supports Expo / React Native / Flutter / native builds, and integrates with your CI pipeline and AI coding tools.

Install

brew install RevylAI/tap/revyl          # Homebrew (recommended)
uv tool install revyl                   # uv
pip install revyl                       # pip

Authenticate

revyl auth login                        # Browser-based login (stores credentials locally)

Or set an API key directly:

export REVYL_API_KEY=your-api-key

Quick Start

cd your-app
revyl init                              # Guided wizard: auth, build system, apps
revyl dev                               # Launch TUI: live device + hot reload

From the dev TUI you can interact with a cloud device in real time, then convert what works into tests:

revyl dev test create login-flow        # Create a test from the live session
revyl dev test run login-flow           # Run it against the hot-reload build
revyl dev test open login-flow          # Open in the browser editor

When you're ready to run outside the dev loop:

revyl test run login-flow --build       # Build, upload, and run in one step
revyl workflow create smoke-tests --tests login-flow,checkout
revyl workflow run smoke-tests          # Run the full workflow

YAML-first creation can bootstrap local state without a pre-existing .revyl/config.yaml:

revyl test create login-flow --from-file ./login-flow.yaml

See Creating Tests for the full authoring workflow, YAML examples, module imports, and troubleshooting.

revyl dev starts your local dev server, tunnels it to a cloud device, and installs the latest build automatically. Use --platform android or --platform ios to pick a platform (defaults to iOS).

MCP Server

Connect Revyl to your AI coding tools -- your agent gets cloud devices, test execution, and device interaction out of the box.

Tool	Setup
Cursor	Add to .cursor/mcp.json: {"mcpServers":{"revyl":{"command":"revyl","args":["mcp","serve"]}}} (full guide)
VS Code
Claude Code	claude mcp add revyl -- revyl mcp serve
Codex	codex mcp add revyl -- revyl mcp serve

Full setup guide -- includes Windsurf, Claude Desktop, and agent skills

Device SDK

pip install revyl

from revyl import DeviceClient

with DeviceClient.start(platform="ios") as device:
    device.tap(target="Login button")
    device.type_text(target="Email", text="user@test.com")
    device.instruction("Open Settings and tap Wi-Fi")
    device.validation("Verify Wi-Fi settings are visible")
    device.screenshot(out="screen.png")

See Device SDK Reference for the full API.

Agent Skills

Install agent skills to improve how your AI coding tool uses Revyl:

revyl skill install              # Auto-detect tool; install CLI skill family
revyl skill install --mcp        # Install MCP skill family
revyl skill install --cli --mcp  # Install both

See Agent Skills for the full list and prompt examples.

What You Can Do

Feature	Command	Docs
Run tests	revyl test run <name>	Commands
Run workflows	revyl workflow run <name>	Commands
Cloud devices	revyl device start	Commands
Dev loop (Expo)	revyl dev	Commands
Build and upload	revyl build upload	Commands
Publish to TestFlight	revyl publish testflight	Commands
CI/CD	GitHub Actions	CI/CD
Device SDK	pip install revyl	Device SDK
Agent skills	revyl skill install	Skills

Documentation

• Command Reference -- full list of every command and flag
• Creating Tests -- YAML-first workflows, modules, and troubleshooting
• Configuration -- .revyl/config.yaml reference
• MCP Setup -- AI agent integration for all tools
• Agent Skills -- embedded skills for device loops, test creation, failure analysis
• Device SDK -- Programmatic device control
• CI/CD -- GitHub Actions integration
• Development -- internal dev workflow, hot reload, --dev mode
• Releasing -- version bumping, release pipeline
• Public Docs -- full documentation site

Troubleshooting

Xcode / Command Line Tools errors during brew upgrade revyl

softwareupdate --all --install --force
sudo xcode-select -s /Library/Developer/CommandLineTools
brew upgrade revyl

If softwareupdate does not install Command Line Tools, reinstall them:

sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --install

If you use full Xcode builds, install the latest Xcode version from the App Store and then run:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

Homebrew directory ownership errors

sudo chown -R "$(whoami)" /opt/homebrew /Users/"$(whoami)"/Library/Caches/Homebrew /Users/"$(whoami)"/Library/Logs/Homebrew
chmod -R u+w /opt/homebrew /Users/"$(whoami)"/Library/Caches/Homebrew /Users/"$(whoami)"/Library/Logs/Homebrew

License

MIT