Mobilerun Docs Reference
droidrun/mobilerun
Answers questions about Mobilerun, the LLM-agent framework for automating Android and iOS devices, by pointing the agent to the right page of its v5 documentation.
Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn.
Install Simvyn
$ npx skills add pranshuchittora/simvyn --skill simvyn -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pranshuchittora/simvyn simvyn --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pranshuchittora/simvyn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/simvyn .claude/skills/simvyn && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "simvyn" agent skill from https://github.com/pranshuchittora/simvyn/tree/main/skills/simvyn into .claude/skills/simvyn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "simvyn", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pranshuchittora/simvyn/tree/main/skills/simvynType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pranshuchittora/simvyn --skill simvyn -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pranshuchittora/simvyn simvyn --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pranshuchittora/simvyn.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/simvyn .agents/skills/simvyn && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "simvyn" agent skill from https://github.com/pranshuchittora/simvyn/tree/main/skills/simvyn into .agents/skills/simvyn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "simvyn", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pranshuchittora/simvyn --skill simvyn -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pranshuchittora/simvyn simvyn --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pranshuchittora/simvyn.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/simvyn .cursor/skills/simvyn && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "simvyn" agent skill from https://github.com/pranshuchittora/simvyn/tree/main/skills/simvyn into .cursor/skills/simvyn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "simvyn", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pranshuchittora/simvyn.git --path skills/simvyn--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pranshuchittora/simvyn --skill simvyn -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pranshuchittora/simvyn simvyn --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pranshuchittora/simvyn.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/simvyn .gemini/skills/simvyn && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "simvyn" agent skill from https://github.com/pranshuchittora/simvyn/tree/main/skills/simvyn into .gemini/skills/simvyn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "simvyn", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pranshuchittora/simvyn simvynInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pranshuchittora/simvyn --skill simvyn -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pranshuchittora/simvyn.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/simvyn .github/skills/simvyn && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "simvyn" agent skill from https://github.com/pranshuchittora/simvyn/tree/main/skills/simvyn into .github/skills/simvyn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "simvyn", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pranshuchittora/simvyn --skill simvyn -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pranshuchittora/simvyn simvyn --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pranshuchittora/simvyn.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/simvyn .opencode/skills/simvyn && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "simvyn" agent skill from https://github.com/pranshuchittora/simvyn/tree/main/skills/simvyn into .opencode/skills/simvyn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "simvyn", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
simvyn- GitHub stars
- 438
- Token cost
- ~938 tokens
- SKILL.md length
- 450 words
- Files
- 7 (incl. scripts, references)
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- MIT
At a glance
Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn.
- Device discovery
- SKILL.md covers Start with the installed CLI, Choose the relevant reference and Execute and verify within the…
- Runs JavaScript scripts from its folder; calls node
- App installation and launch
What it does
Simvyn is an agent skill from pranshuchittora/simvyn. Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn. Use for device discovery, app installation and launch, screenshots, logs, deep links, location simulation, app data inspection, device settings, and reusable device workflows through the Simvyn CLI or dashboard.
Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/automation.md` and `references/cli.md`).
It sits in Mobile, covering Mobile testing and debugging. It works with Android and iOS. The repository describes itself as: Universal mobile devtool for Agents & Humans - control iOS Simulators, Android Emulators, and real devices from a single dashboard and CLI. The licence is MIT.
When your agent uses it
- Device discovery
- App installation and launch
- Location simulation
- App data inspection
Example prompts
- “/simvyn”
Requirements
- Node.js
What it can do on your machine
Read from SKILL.md and the folder at commit 65b45fe. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Simvyn loads about 938 tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 76 tokens; SKILL.md has 450 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from pranshuchittora/simvyn at commit 65b45fe, republished under its MIT licence (© pranshuchittora). 450 words, ~938 tokens.
Download SKILL.mdSave it as
.claude/skills/simvyn/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.- name
- simvyn
- description
- Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn. Use for device discovery, app installation and launch, screenshots, logs, deep links, location simulation, app data inspection, device settings, and reusable device workflows through the Simvyn CLI or dashboard.
- license
- MIT
Simvyn
Use Simvyn to inspect or operate the user's mobile development environment. This is a CLI workflow skill and does not register MCP tools. When the simvyn, simvyn_screenshot, simvyn_logs, and simvyn_record tools are available, as in Pi with the simvyn package installed, prefer them over the launcher: they resolve the CLI, bound log and recording captures, and return screenshots as images. The references below apply to both.
Requires Node.js 22 (22.14.0+) or 24+ and an installed or built Simvyn CLI. macOS supports iOS and Android; Linux supports Android. iOS requires Xcode and simulator runtimes; Android requires adb and configured devices or emulators. See the platform reference for operation-specific requirements.
Start with the installed CLI
Resolve paths relative to this skill directory, not the user's project directory. The supplied launcher prefers the CLI bundled beside the installed skill, then a built Simvyn checkout, then simvyn on PATH. It does not download packages, build the project, or start a server on its own.
node /absolute/path/to/skills/simvyn/scripts/simvyn.mjs --version
node /absolute/path/to/skills/simvyn/scripts/simvyn.mjs device list --jsonIn the references, simvyn means this resolved invocation, or the user's existing simvyn executable when appropriate. Read --help for the installed command if its version differs from these references. Running with no arguments starts the dashboard; use an explicit subcommand for headless work.
Choose the full device ID from discovery and retain it through the task. Device name and ID-prefix matching are inconsistent across commands. Rediscover after booting an Android AVD because avd:<name> changes to an emulator-<port> ID. Most operations require a booted device. A discovered physical device may still need to be unlocked or trusted.
Show full SKILL.md (193 more words)Show less
Choose the relevant reference
- CLI commands: argument order, supported options, output forms, and commands missing from brief help examples.
- Platform support: read before physical-device operations, permissions, app data inspection, clipboard work, or selecting an iOS/Android equivalent.
- Recipes: app repro sessions, screenshots, Android local development, GPS and push testing, accessibility checks, and multi-device collections.
- Automation and troubleshooting: read for scripts/CI, JSON parsing, long-running processes, failed commands, and collection result interpretation.
Execute and verify within the task
Use the actions needed for the user's request. Inspect an existing collection with collections show before applying it: its name does not reveal whether it erases data, launches apps, or changes settings. Preserve any existing authorization; when a requested diagnosis does not include deleting/resetting data, propose the concrete reset before doing it.
Save screenshots, recordings, and downloaded files to explicit paths and inspect the artifacts needed to substantiate the result. A screenshot command returns a path; the agent must use its own image-viewing tool to inspect the image. Report the device, actions performed, artifact locations, and observed failures or unsupported operations. Do not infer success from a command being available or from a collection's zero exit status alone.
© pranshuchittora, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 6 other files (scripts, references) in skills/simvyn of pranshuchittora/simvyn.
- SKILL.md
- agents/openai.yaml
- references/automation.md
- references/cli.md
- references/platforms.md
- references/recipes.md
- scripts/simvyn.mjs
Open the folder on GitHubat commit 65b45fe
Compare with similar skills
Simvyn next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Simvyn this skillpranshuchittora/simvyn | 438 | — | ~938 | Automated safety check: Pass | MIT | |
| Mobilerun Docs Referencedroidrun/mobilerun | 9.6k | — | ~943 | Automated safety check: Pass | MIT | |
| Appiumblokadaorg/blokada | 3.3k | — | ~3.5k | Automated safety check: Pass | MPL-2.0 | |
| Phoneagentrounak/PhoneAgent | 798 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Mobile Automation with agent-devicenuclearpasta/react-native-drax | 715 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Device Logblokadaorg/blokada | 3.3k | — | ~762 | Automated safety check: Pass | MPL-2.0 |
Similar skills
Appium
blokadaorg/blokada
A skill your agent uses for dynamic inspection and navigation of the Blokada app through the repo-local Appium machine session.
Phoneagent
rounak/PhoneAgent
Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.
Mobile Automation with agent-device
nuclearpasta/react-native-drax
Drives iOS and Android devices and simulators from the command line: open apps, snapshot the UI tree, tap, type, scroll, take screenshots and read UI info.
Device Log
blokadaorg/blokada
A skill your agent uses for pulling recent Blokada app logs from a connected device, using the same share-log file exposed in Settings.
Screenmap
aleqsio/screenmap
Generate a visual navigation map of an Expo / React Native or NativeScript app.
Related
Categories
Questions about Simvyn
What does Simvyn do?
Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn. Simvyn is an agent skill from pranshuchittora/simvyn. Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn.
When should I use Simvyn?
Simvyn fits situations like: device discovery; app installation and launch; location simulation; app data inspection.
How do I install Simvyn in Claude Code?
Run `npx skills add pranshuchittora/simvyn --skill simvyn -a claude-code`. Or copy the skill folder (skills/simvyn in pranshuchittora/simvyn) into .claude/skills/simvyn in your project. Claude Code loads it when a task matches its description.
How do I install Simvyn in Codex?
Run `npx skills add pranshuchittora/simvyn --skill simvyn -a codex`. Or copy the skill folder (skills/simvyn in pranshuchittora/simvyn) into .agents/skills/simvyn in your project. Codex loads it when a task matches its description.
Can I use Simvyn in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pranshuchittora/simvyn --skill simvyn -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/simvyn, .gemini/skills/simvyn, .github/skills/simvyn and .opencode/skills/simvyn in your project.
What does Simvyn need to run?
Going by SKILL.md and its folder, Simvyn needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.
Does Simvyn access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Simvyn safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Simvyn use?
Simvyn is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Simvyn use?
About 938 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.
What are the alternatives to Simvyn?
Skills that share tags, products or a category with Simvyn: Mobilerun Docs Reference (droidrun/mobilerun, 9.6k stars), Appium (blokadaorg/blokada, 3.3k stars), Phoneagent (rounak/PhoneAgent, 798 stars) and Mobile Automation with agent-device (nuclearpasta/react-native-drax, 715 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Simvyn?
pranshuchittora (a GitHub user) maintains it in pranshuchittora/simvyn, which has 438 GitHub stars. The repository was last updated on October 7, 2026.
Source: pranshuchittora/simvyn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.