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

curl -fsSL https://raw.githubusercontent.com/RevylAI/revyl-cli/main/scripts/install.sh | sh  # Shell (macOS / Linux)
brew install RevylAI/tap/revyl          # Homebrew (macOS)
pipx install revyl                      # pipx (cross-platform)
uv tool install revyl                   # uv
pip install revyl                       # pip

Authenticate

Create a free account at app.revyl.ai, then log in via the CLI:

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

Or set an API key directly (generate one from your dashboard):

export REVYL_API_KEY=your-api-key

Quick Start

cd your-app
revyl doctor                            # Check CLI, auth, connectivity
revyl auth login                        # Browser-based login (if not already authed)
revyl init                              # Guided wizard: build system, apps
revyl build upload                      # Build and upload a dev binary
revyl dev                               # Launch TUI: live device + hot reload

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).

Agent Skills

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

revyl skill install              # Auto-detect tool; install CLI skill family

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
CI/CD	GitHub Actions	CI/CD
Device SDK	pip install revyl[sdk]	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
• 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