Simvyn

simvyn

Universal mobile devtool — control iOS Simulators, Android Emulators, and real devices from a single dashboard and CLI

Table of Contents

• Quick Start
• Installation
• AI Coding Agents
• Features
• Module Showcases
• Collections Guide
• CLI Reference
• How It Works
• Supported Platforms
• Contributing
• Security
• License

Quick Start

npx simvyn

Starts the local server, opens the web dashboard in your browser, and discovers all connected simulators, emulators, and USB-connected physical devices automatically.

Installation

Global install:

npm install -g simvyn

One-time use (no install):

npx simvyn

Requirements:

• Node.js 22 (22.14.0+) or 24+
• macOS (full iOS + Android support) or Linux (Android only)

AI Coding Agents

simvyn includes a portable Agent Skill for discovering devices, running supported CLI commands, capturing screenshots, inspecting app data, and collecting bounded logs. It teaches an agent to use the CLI with explicit device IDs and platform limits. The skill uses the agent's existing terminal tool; it does not register an MCP server or new agent tools.

Pi: the npm package is a Pi package. Along with the skill, it adds simvyn, simvyn_screenshot, simvyn_logs, and simvyn_record tools, a /simvyn command that runs the dashboard, and /simvyn-repro, /simvyn-screen, and /simvyn-logs prompt templates. It requires Pi 0.74 or later:

pi install npm:simvyn

Other compatible agents: install the portable skill from GitHub, selecting your agent, and install the simvyn CLI separately:

npm install -g simvyn
npx skills add pranshuchittora/simvyn --skill simvyn --agent codex --yes

The GitHub command requires these skill files to be present on the default branch; the Pi command requires the Pi resources in the published npm release. For unreleased changes, use the local checkout instructions.

See the agent setup and workflow guide for the bundled launcher, supported outputs, noninteractive operation, and current limitations. A compact documentation index is also available for tools that accept documentation URLs.

Features