Revyl
com.revyl由 revyl.com 发布v1.0.0更新于 Nov 21, 2026
iOS simulators, Android emulators, web browsers and macOS computers for agents to verify their work
概览
Revyl 为 AI 编码代理提供云端 iOS 模拟器、Android 模拟器、浏览器和 Mac,用于运行应用测试并验证工作成果。
- 可以做什么
- 启动或接入实时设备开发循环,并与运行中的应用交互
- 从云端设备截取屏幕截图和报告以验证改动
- 编写、校验、推送并运行自然语言或 YAML 测试、工作流与应用探索
- 将应用界面与 Figma 设计稿或跨平台界面进行比对
- 在项目中安装和管理 CLI 的代理技能
- 适用场景
- 当代理需要真正运行并目视检查 iOS、Android、Web 或 Mac 应用,而不只是根据代码推断时适用;也适合希望把自然语言测试放到云端设备执行并接入 CI 的团队。
- 运行要求
- 需连接 backend.revyl.ai 远程端点并通过 OAuth 登录,同时需要免费的 Revyl 账户。文档流程还会安装 Revyl CLI(shell 安装脚本、Homebrew、pipx 或 uv)并完成认证,可浏览器交互登录,或通过 REVYL_API_KEY 使用 API 密钥。需要访问 Revyl 云服务的网络连接。
安装
在 SourceWeft 中
- 打开 控制台中的 Revyl,将其添加到工作区。
- 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
- 为需要使用其工具的对话启用该服务。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
交给智能体安装
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/com.revyl%2Frevyl/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。其他 MCP 客户端
把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。
{
"mcpServers": {
"revyl": {
"type": "http",
"url": "https://backend.revyl.ai/api/v1/mcp"
}
}
}README
Revyl
Proactive Reliability for Your Apps
[Version] [License: MIT] [Homebrew] [PyPI]
Revyl is an AI-powered testing platform for your apps. Define tests in natural language, run them on cloud devices and computers, and catch bugs before your users do. It works with iOS, Android, web and Mac, supports Expo / React Native / Flutter / native builds, and integrates with your CI pipeline and AI coding tools.
For coding agents
To set up Revyl for a user, run these from the app's directory:
To sign in, run revyl auth login and post the approval URL it prints as a
link; the user can approve it from any browser. A hosted agent with
REVYL_API_KEY in its environment is already signed in; it also runs
revyl auth persist-cloud-env so an MCP server that does not inherit the
variable can use it. Then follow the revyl-cli-dev-loop skill to start a
cloud device with revyl dev --remote --detach --json, and share the
viewer_url it returns.
In a project that already uses Revyl, the open skills installer adds the same recommended skills:
#stable matches the latest CLI release; main can be ahead of it. Name an
optional skill from revyl skill list --all with --skill <name>, and refresh
with npx skills update. For MCP and editor setup, see
MCP Setup.
Install
sh
The sh installer runs on macOS, Linux, and Windows Git Bash, MSYS2, or
Cygwin, where it installs revyl.exe into ~/.revyl/bin and prints the PATH
steps for Git Bash and PowerShell. When it cannot write your shell profile, for
example one Nix manages, it still installs the binary and prints the export PATH line to add yourself.
Windows PowerShell
Homebrew (macOS)
pipx (cross-platform)
uv
The PyPI package is CLI-only and contains the native binary for your platform,
so uv, pipx, and pip do not download executable code at first run.
See Local runtime files for managed storage paths, permissions, and directory-symlink restrictions.
For a restricted or headless runner, see Sandboxed environments. It covers a writable home and runtime state directory, non-interactive PATH, proxy and CA trust, minimum egress, and the boundary between local inspection and authorized cloud actions.
Authenticate
Create a free account at app.revyl.com, then log in via the CLI:
The CLI prints an approval URL and a short code and waits. Open the URL wherever you are signed in — it does not have to be this machine, so the same command works over SSH, in a container, and in a cloud agent.
For an unattended machine, use an API key from your dashboard instead:
Quick Start
revyl init always writes a stable project.id in .revyl/config.yaml. When
detection succeeds, it also writes build.framework and named profiles for the
detected iOS and/or Android platforms before any optional interactive onboarding.
Supplying a project ID writes it locally but does not validate, attach, or publish
it; use -y to stop after local config creation. Authenticated interactive setup
can continue into revyl github setup after the project config has been written.
GitLab automation is configured separately with revyl gitlab setup.
When the connected provider
can access the repository, committing that valid config to the repository's default branch
reconciles a matching server project or creates a new Git-managed project when
its project.id, project root, and config path are unclaimed and its references
are valid. Pull requests validate new configs as unpublished bootstrap candidates;
creation occurs only from the actual merged default-branch commit. revyl config push remains the explicit manual publication and recovery path.
For GitLab automation tokens, terminal connection, and manual webhooks, see Connect GitLab.
For an existing legacy file, preview or perform the local conversion explicitly:
A successfully prepared legacy migration uses one concise human-readable
summary of whether fields will be dropped or defaulted; a write creates an
exact-byte backup. JSON --check output contains the complete migration
proposal and migration ledger. Migration
externalizes legacy top-level test aliases to conflict-checked
.revyl/tests/<alias>.yaml files, preserves an existing matching mapping
byte-for-byte, and stops on destination conflicts because those are unsafe to
write. The retired top-level workflow alias cache is reported and removed.
The conversion exists only in your checkout until you commit it. After
migrating, commit the converted .revyl/config.yaml and any new
.revyl/tests/ files with your change, but not the backup; otherwise every
fresh checkout fails with the legacy-format error again. A write lists those
files, and --write --json reports them in
uncommitted_config_migration.repository_relative_paths_to_commit. Until the
commit lands, commands that read the project config print a one-line stderr
reminder at most once every 24 hours per machine, never with --json or
--quiet. If you can't commit, tell the repository owner.
When authenticated, migration may make read-only verified lookups to reuse or
interactively select a project from the verified repository, resolve enabled
legacy PR-build app names to exact platform app IDs, and resolve legacy PR
workflow names to exact organization workflow IDs.
Missing, duplicate, or inaccessible workflow names are omitted and reported,
including the implicit smoke workflow from the legacy smoke_every_pr
preset. An enabled PR build is never silently omitted: app or framework meaning
that still cannot be resolved is reported as lossy and omitted from the best-effort
proposal. Inspect JSON --check before writing; afterward, compare the reported
backup or ask a coding agent to reconcile omissions. Migration
never creates or attaches a server project, pulls or publishes configuration,
or otherwise mutates server state. Edit the project YAML directly when you
need to change project settings, then run revyl config validate.
You can also create and edit manual-authority projects from the GitHub integration in
the Revyl web app. After creating a project there, run revyl config pull from that
project root (or a directory beneath it). If no local config exists, the CLI verifies
the connected repository and writes the nearest matching project's configuration to
its exact .revyl/config.yaml path; it never imports legacy or invalid remote state.
When an existing config differs, pull creates an exact-byte backup, atomically
replaces the file, and reports the backup path without prompting. If the local
project was deleted and exactly one active replacement owns that same root, pull
performs the same backup and replacement without trusting the stale ID.
Project roots are immutable. Correct a mistaken root by deleting the manual project
in the web app, creating its replacement at the intended root, then running
revyl -C <replacement-root> config pull. A Git-managed project must first return to manual
authority by removing its designated config file from the repository's default branch; that file
removal alone preserves the project and its automation. Project deletion remains a
web operation—there is no CLI project-delete command—and preserves the repository
connection, GitHub installation, report destination, historical results, and work
that already started.
Build profiles are customer-named recipes, not active modes. A profile can
contain an iOS recipe, an Android recipe, or both. Select the profile and
platform per invocation. revyl build executes the recipe on a Revyl cloud
runner by default, with its remote image and caches:
When omitted values have exactly one eligible choice, the CLI resolves them. Otherwise it prompts interactively or fails non-interactively with the valid choices. No profile is stored as active or default.
See Build with Revyl for prerequisites, source uploads,
billing, and migration guidance for existing scripts. Builds land on --branch
when supplied. Otherwise they use your Git branch when automatic Git branch
detection is enabled in the app's Build branches settings, or the app's default
branch when detection is disabled or no Git branch is available. See
Build branches from the CLI.
When you're ready to run outside the dev loop:
Blocking human-terminal test and workflow runs open their completed report by
default. Use --no-open to suppress it. No-wait, JSON, GitHub Actions, CI,
SSH, and other headless executions never open a browser.
YAML-first creation requires the selected project to already have a
.revyl/config.yaml. Pull an existing registered project, initialize a new
local project, or migrate a legacy file before creating the test:
test create --from-file validates and copies the YAML into the selected
project; it never creates or migrates project configuration.
See the Revyl Docs for the full authoring workflow, YAML examples, module imports, and troubleshooting.
revyl devstarts a live-device development loop and installs a build from one named profile/platform recipe. Pass--build-profileand--platformexplicitly, or let Revyl resolve a unique development-like or sole eligible choice. Ambiguous interactive runs prompt; non-interactive runs fail with the valid choices. No profile or platform is stored as active or default.
Agent Skills
For guided comparisons of Figma frames or components with Atlas screenshots, see the Figma review handoff, including a shareable setup prompt and private report or annotation options. For iOS/Android comparisons without Figma, use the cross-platform review handoff. It compares confirmed matching states without treating unmatched screens as missing features.
Interactive revyl init offers optional agent skill setup. Choose your tool
and the skills you want; the recommended skills are preselected, and an empty
selection skips installation. The standalone revyl skill install command uses
the same preselected skill picker:
Without --name, noninteractive installs, --yes, and --json install the
recommended skills from revyl skill list and name them on stderr; --json
output adds "selection": "default". Repeat --name to choose specific
skills, and use --all only when you deliberately want the entire catalog.
Packages live in .agents/skills/, which Cursor and Codex discover directly.
Claude Code uses per-skill relative links under .claude/skills/. Other agents
that read the shared directory can also discover these skills. --global
selects the equivalent directories under your home directory; --copy keeps
independent packages in each selected tool's legacy skill directory instead.
Conflicting legacy packages in any agent directory block shared storage, even
when you selected another agent. This includes retired auth-bypass platform
aliases; Revyl preserves rather than prunes them. Noninteractive installs then
continue as if --copy were given; move conflicting copies aside to switch to
shared storage. In init, choose Claude Code (copy mode) when Claude
compatibility links are unavailable.
A symlinked shared directory must resolve inside the selected project or home
directory. Installation does not modify
AGENTS.md or inject Cursor rules. For client-specific setup and optional MCP,
see MCP Setup.
Installation copies the complete skill package, including source-authored
agent metadata and any references, scripts, or assets. show and export
return only the root SKILL.md, not an installable package. Auth-bypass loads
only the reference for the detected stack. Auth-bypass and Atlas review require
an explicit user request; ordinary workflows allow implicit invocation.
Existing packages are unchanged unless you explicitly use --force, which
replaces the selected package and discards local edits. Prefer
revyl skill update to refresh already-installed, Revyl-managed packages from
your CLI version: it preserves local edits and unmanaged packages, reports conflicts,
and never adds skills. revyl upgrade updates only the binary and may remind
you to run revyl skill update; it does not install or refresh skills.
A customized package is reported as preserved and makes skill update exit
non-zero, so name only the skills you want refreshed. See
Agent skills for the reminder and older CLIs.
Use revyl-cli-dev-loop when you want the agent to start or attach to a generic
Revyl dev loop, interact with the device, and verify with screenshots or
reports. Use revyl-cli-atlas when the agent should explore an app bottom-up as
a graph, opening relevant screenshots at each node and tracing misunderstood
connections backward through edge clips and their originating reports. Use
revyl-cli-atlas-review when the user explicitly asks the agent to create or
manage grounded Atlas annotations. Use
revyl-cli-create when you want the agent to author or refine a
stable Revyl YAML test, validate it, push it, run it, and iterate from reports.
Use revyl-cli-auth-bypass when the agent should set up test-only auth bypass
after inspecting the app. Implement the handler in the detected stack; do not
install a separate platform skill.
Example prompts:
Documentation
For full documentation of the CLI see the Revyl Docs.
Troubleshooting
Xcode / Command Line Tools errors during brew upgrade revyl
If softwareupdate does not install Command Line Tools, reinstall them:
If you use full Xcode builds, install the latest Xcode version from the App Store and then run:
Homebrew directory ownership errors
License
MIT
来源:README.md,提交 fb6e8b2
工具
0版本历史
1- v1.0.0最新Nov 21, 2026
评分
已满足适用检查项的 85%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通必需25 分
- 已声明认证方式必需10 分
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分