Emuluxe CLI 🚀

Emuluxe CLI is the fast path for repeat mobile simulation. It lets you launch Emuluxe directly from terminal so you can move from command line to editor-native mobile simulation in one step.

Use it when the VS Code or Cursor workflow already fits your team and you want a faster way to start the same simulation flow repeatedly.

🌟 Features

• Zero-Install: Run instantly with npx.
• Global Commands: Install globally for one-word access (emx).
• Instant Launch: Robust IDE detection (Antigravity, Cursor, VS Code, Windsurf).
• Zero-Config Token Sync: Automatically shares credentials with the Emuluxe MCP server.
• Repeat Workflow Speed: Great for developers who run the same mobile simulation checks often.
• AI-Ready Stack: Fits naturally into Emuluxe's AI-powered debugging and agent workflows.

Best for

• Developers who already use Emuluxe in VS Code or Cursor
• Terminal-driven workflows where speed matters
• Repeated localhost or URL launches
• Teams that want a power-user path without leaving their shell
• Developers who want simulation first, then AI-assisted debugging when needed

🚀 Installation

Option 1: Zero-Install (Recommended)

Run it directly without installing anything permanently:

npx @emuluxe/cli start https://your-site.com

Option 2: Global Install

Access Emuluxe anywhere with the emx command:

npm install -g @emuluxe/cli

🛠 Usage

Start a Simulation

emx start https://example.com --device iphone-15-pro-max

Typical flow:

1. Start your local app or identify the page you want to review
2. Run emx start ...
3. Let Emuluxe open the right IDE surface
4. Simulate, inspect, rotate, and capture proof
5. Repeat whenever the UI changes

Arguments:

• url (string, required): The URL to simulate.
• -d, --device <id>: The device ID (e.g., iphone-15-pro-max, pixel-8-pro).
• -p, --profile <name>: The simulation profile to use.

🔐 Configuration

Set API Token

To authenticate your CLI and MCP server:

emx login
# OR
emx set-token your_token_here

Set Default Device

Save your preference:

emx set-device pixel-8-pro

🔍 How it Works

The CLI creates a secure tunnel (if needed) and a simulation session. It then detects your current environment and triggers the Emuluxe IDE deep link (antigravity://, cursor://, windsurf://, or vscode://).

This makes the CLI the fastest way to jump into the same mobile simulation workflow your team already uses in the editor.

IDE Support

• Antigravity: Native detection via APP_NAME.
• Cursor: Native detection via VSCODE_ICON_KEY and bundle IDs.
• Windsurf: Native detection via bundle ID com.exafunction.windsurf.
• VS Code: Native detection via TERM_PROGRAM.

📄 License

ISC © Emuluxe