Remote View
Remote View lets you see a supported IDE session's screen and interact with it directly from the dashboard.
Cloud is the main path for internet-facing remote access. On self-hosted, the same view works only through your local/LAN dashboard path.
Opening Remote View
- Open an IDE session from the dashboard or a machine's Workspace tab.
- Open Remote for that session.
- ADHDev opens the remote surface and starts the screenshot stream for that IDE session.
Viewing Modes
Split View
On desktop, the standard remote surface opens as a split dialog with chat on one side and the IDE screen on the other.
Remote-Only View
You can switch the same dialog into a remote-only mode when you want the screen to take over the full workspace.
Preview Surfaces
Some layouts also show a smaller screenshot preview before you open the full remote dialog.
Interaction
When Remote View is active, you can control the IDE session:
| Action | Desktop | Mobile |
|---|---|---|
| Click | Mouse click | Tap |
| Right-click | Right mouse button | Long press |
| Double-click | Double click | Double tap |
| Type | Physical keyboard | On-screen keyboard |
| Scroll | Mouse wheel / trackpad | Two-finger swipe |
| Zoom | — | Pinch to zoom |
Visual Feedback
Every click shows a ripple effect at the click location so you know the click was registered.
Performance
Direct Connection (STUN)
When P2P connects directly (no relay), screenshots are fast and responsive:
- Refresh rate adapts automatically (faster when screen changes, slower when static)
- Quality: High (JPEG quality 25)
Relay Connection (TURN)
When P2P goes through TURN relay (usually when behind strict NAT):
- Slightly slower refresh rate
- Lower quality (JPEG quality 12) to reduce bandwidth
- Still fully functional for monitoring and control
Plan-based Limits
Cloud account limits:
| Plan | Plan Floor | Relay Budget |
|---|---|---|
| Free | 5 seconds | 60 minutes/day |
| Pro | 2 seconds | 4 hours/day |
| Team | 2 seconds | Unlimited |
| Enterprise | No added plan floor | Unlimited |
INFO
The relay budget applies to TURN-relayed screenshot time. Direct P2P paths do not consume that cloud relay budget.
INFO
These quotas are cloud plan limits. Self-hosted does not use cloud screenshot budgets, but it also does not provide the hosted remote-access path outside your network.
Troubleshooting
"CDP not connected" warning
Your IDE needs to be running with CDP enabled. Relaunch with:
adhdev launch <supported-ide>Black screen / No screenshots
- Check that the IDE is actually open and visible on your machine
- Verify P2P connection state
- Try closing and reopening Remote View
Slow or laggy
- Check if you're on TURN relay (shown in connection info)
- Close other P2P-heavy applications
- Try a network with better NAT traversal (STUN direct is fastest)
Session opens but remote controls feel limited
- Treat Remote View as an IDE workflow first, not a blanket remote desktop promise
- Cursor is the strongest current public starting point for Remote View
- If the IDE itself is only partially validated, chat can still work better than remote controls
Next Steps
- CLI Agents → — manage terminal-based agents
- Dashboard → — back to dashboard basics