| name | erne-setup-device |
| description | ERNE — Install and configure agent-device MCP server for simulator/emulator control |
/erne-setup-device — Setup Device Control
You are executing the /erne-setup-device command. This is script-driven — it sets up the agent-device MCP server.
What This Does
Installs and configures the agent-device MCP server so commands like /erne-debug, /erne-perf, /erne-component, and /erne-deploy gain visual device interaction capabilities.
Process
Step 1: Check Prerequisites
xcodebuild -version
xcrun simctl list devices
adb version
emulator -list-avds
Step 2: Install agent-device MCP
Check if already configured in .claude/settings.json:
{
"mcpServers": {
"agent-device": {
"command": "npx",
"args": ["-y", "agent-device"]
}
}
}
If not present, add the configuration.
Step 3: Verify Connection
xcrun simctl boot "iPhone 16 Pro"
emulator -avd Pixel_8_API_35 &
Test that agent-device can:
- Take a screenshot
- Detect booted device
- Perform a tap action
Step 4: Configure Command Integration
After setup, these commands gain enhanced capabilities:
| Command | Enhancement |
|---|
/erne-debug | Screenshot reproduction steps, tap through UI |
/erne-perf | Measure real FPS, capture actual jank frames |
/erne-component | Render on device, visual verification screenshot |
/erne-deploy | Launch preview build, verify UI before submit |
/erne-build-fix | Build, install, and launch to verify fix |
Output
## agent-device Setup Complete
### Status
- MCP server: Configured ✓
- iOS Simulator: Available (iPhone 16 Pro)
- Android Emulator: Available (Pixel 8 API 35)
### Capabilities Enabled
- Screenshot capture
- Tap/type/swipe interaction
- App navigation
- Visual verification
### Commands Enhanced
/debug, /perf, /component, /deploy, /build-fix
now have visual device control.
Troubleshooting
| Problem | Solution |
|---|
| iOS simulator not found | Install Xcode, run xcode-select --install |
| Android emulator not found | Install Android Studio, create AVD in AVD Manager |
| agent-device fails to connect | Check MCP server config in .claude/settings.json |
| Screenshots are black | Wait for device to finish booting, retry |