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] emx automatically 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_KEY and 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.run tunnel.
- 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.

Next, explore the REST API Reference.

Loading Emuluxe

CLI Toolchain (emx)