Emuluxe CLI 🚀

Emuluxe CLI is the ultimate command-line tool for mobile web simulation. It allows you to instantly launch mobile environments for any website directly from your terminal, automatically triggering simulation panels in your IDE.

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

🚀 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

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 Extension Deep Link (antigravity://, cursor://, windsurf://, or vscode://).

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