CLI Toolchain (emx)
The Emuluxe CLI (emx) is a professional terminal interface designed to bridge your local development environment with our high-fidelity cloud hardware foundry. It automates local tunneling, hardware fingerprinting, and session management with zero configuration.
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
Authentication
-
Obtain Token: You can find your secure API token in the Settings -> Integrations section of your Emuluxe dashboard.
-
Set Token: Pair your local environment with your Emuluxe account:
emx set-token your_secure_token -
Login: Alternatively, run the login command to open the dashboard:
emx login
Core Commands
emx start [url]
Launch a high-fidelity simulation session.
url: The target URL (Default:http://localhost:3000).--device, -d: Override the default hardware profile for this session.
Example: Starting a session with a specific device
emx start http://localhost:8080 -d iphone-15-pro-max
[!NOTE]
emxautomatically initializes an encrypted Local Tunnel relative to your target URL, allowing our cloud devices to securely access your local server.
emx set-device <id>
Sets your preferred default hardware profile.
Instant Auto-Launch
The Emuluxe CLI features a robust IDE detection engine. When you run emx start, it automatically identifies your active coding environment and triggers the Simulation Panel instantly.
Supported IDEs:
- Antigravity: Native detection via
APP_NAME. - Cursor: Native detection via
VSCODE_ICON_KEYand bundle IDs. - VS Code: Native detection via
TERM_PROGRAM.
Configuration
Emuluxe stores global configuration in ~/.emuluxe-cli-nodejs/config.json.
| Key | Description | Default |
|---|---|---|
token | Encrypted API License Token | null |
defaultDevice | Fallback hardware profile | iphone-15-pro-max |
Full Example Workflow
Follow this sequence to launch your first high-fidelity simulation:
-
Authenticate:
emx set-token your_token_here -
Bridge to the Foundry:
emx start http://localhost:3000 -
Result:
- The CLI generates a secure
emuluxe.runtunnel. - Instant Trigger: The session automatically opens in your active IDE (Antigravity, Cursor, or VS Code).
- Physical Rendering: The mobile frame is instantly rendered, pointing to your local code.
- The CLI generates a secure
Next, explore the REST API Reference.