Remote Control Guide
The Remote Control dashboard at verdictide.com/remote lets you monitor and control your IDE from any web browser.
Before You Start
- A verdictide.com account
- At least one registered device
- Verdict IDE running on your device
Registering Your Device
Before you can control a device remotely, you need to link it to your account. This is a one-time setup per device.
Option 1: From the IDE Interface
- Open Verdict IDE
- Click the cloud icon in the top-right corner
- Select "Connect to Cloud"
- A code will appear (e.g.,
BDFG-HJKL) - Go to verdictide.com/device and enter the code
- Click "Approve"
Option 2: From the Command Line
# Run this in your terminal
./bin/verdict auth device
# Output:
# Device Code: BDFG-HJKL
# Visit: https://verdictide.com/device
# Enter the code and approve to complete registrationUsing the Dashboard
Once your device is registered and running, visit verdictide.com/remote.
Device Selection
The dropdown at the top shows all your registered devices. Select the one you want to control.
- Online – Connected and ready
- Offline – IDE not running or disconnected
HUD Panel
The HUD (Heads-Up Display) shows real-time metrics from your IDE:
| Zone | Metrics |
|---|---|
| Cost | Session tokens used, session cost, budget utilization |
| Health | System status, services online, active alerts |
| Tech Debt | Workspace quality score, hotspot count, trend direction |
The HUD updates automatically every 5 seconds while connected.
Task Panel
View and control running tasks:
- Status – Running, Paused, Error, or Completed
- Progress – Visual progress bar with percentage
- Current Step – What the task is doing right now
- ETA – Estimated time remaining
Control Buttons
| Button | Action |
|---|---|
| Pause | Pause a running task (saves tokens) |
| Resume | Resume a paused task |
| Restart | Restart the task from the beginning |
| Clear Error | Clear an error state to retry |
Troubleshooting
"No devices available"
Your account has no registered devices.
Fix: Register a device using the steps above.
Device shows "Offline"
The relay can't reach your local IDE.
Check:
- Is Verdict IDE running?
- Is your internet connection working?
- Try restarting Verdict IDE
"Connecting..." never finishes
The dashboard can't establish a WebSocket connection.
Check:
- Some corporate proxies block WebSocket connections
- Try a different network (e.g., mobile hotspot)
- Check if your firewall blocks outbound WSS
HUD shows "Waiting for data..."
Device is connected but not sending telemetry.
Check:
- The IDE services may still be starting up
- Wait 10-15 seconds for the first telemetry
- If it persists, restart Verdict IDE
Control buttons don't work
Commands are sent but nothing happens.
Check:
- Make sure a task is actually running
- Some operations require the task to be in a specific state
- Check your device is still "Online"