Mobile
ADHDev works well on phones and tablets when you need to review activity, answer approvals, or keep an eye on running sessions away from your desk.
What Mobile Is Best For
Mobile is strongest when you want to:
- check which session needs attention
- approve or reject actions quickly
- read the latest turn from an IDE, CLI, or ACP session
- send a short follow-up message
- jump into Remote View for a supported IDE when needed
It is not meant to replace the full desktop workspace for heavy multi-pane supervision.
Mobile Dashboard Flow
The mobile dashboard uses a simpler flow than desktop.
Expect three main surfaces:
- an inbox-first view for sessions that need attention
- a focused chat view for the currently selected session
- a machine view when you want to inspect or launch work on a specific machine
This keeps the important actions reachable on a small screen without exposing the full desktop dock layout.
Managing Sessions On Mobile
When many sessions are active, the mobile dashboard is designed around triage rather than permanent visibility.
Use:
- Activity inbox for approvals and unread completions
- Hidden tabs to reduce clutter without closing a session
- History to reopen older or resumable sessions
If a session seems to disappear, check those surfaces before assuming the runtime is gone.
Remote View On Mobile
Remote View is available for supported IDE sessions and is useful for quick inspection or light control.
Touch gestures map to common desktop actions:
| Gesture | Action |
|---|---|
| Tap | Click |
| Long press | Right-click |
| Double tap | Double-click |
| Two-finger swipe | Scroll |
| Pinch | Zoom |
| Drag | Mouse drag |
For long editing sessions or detailed layout work, desktop is still the better surface.
Install As An App
Installing ADHDev as a PWA improves the mobile experience:
- faster launch from your home screen
- less browser chrome
- better background behavior
- push notifications in the hosted cloud path
iPhone And iPad
- Open adhf.dev in Safari.
- Tap the Share button.
- Choose Add to Home Screen.
- Open ADHDev from the new home screen icon.
WARNING
On iOS, push notifications require the installed Safari PWA path. A normal browser tab is not enough.
Android
- Open adhf.dev in Chrome.
- Open the browser menu.
- Choose Install app or Add to Home screen.
- Launch ADHDev from the installed shortcut.
Push Notifications
Push notifications are available in the hosted cloud product and are most useful on mobile for:
- approval requests
- completed tasks
- agent errors
To enable them:
- Open Notifications in the dashboard.
- Turn on global notifications.
- Turn on push notifications when prompted.
- Allow notification permission in your browser or operating system.
On iOS, do this from the installed PWA, not from a Safari tab.
Mobile Tips
- Install the PWA if you expect to rely on notifications.
- Use the inbox first when returning after a long idle period.
- Use Wi-Fi for the smoothest Remote View experience.
- For CLI recovery, jump to the machine and inspect Hosted Runtimes instead of launching duplicates.
Troubleshooting
Notifications are not arriving
Check:
- ADHDev notification settings
- browser or OS notification permissions
- iOS PWA installation status
- whether you are using the hosted cloud path rather than self-hosted
Mobile view feels stuck
Try:
- refreshing the page
- reopening the session from the inbox
- reopening the app if the browser suspended the connection too aggressively