AgentOS is built for mobile. Here's how to access it from anywhere.

AgentOS Cloud

With AgentOS Cloud, mobile access is automatic. Your VM comes with a secure subdomain that works from any device.

Your Subdomain

After creating your VM, you get a URL like:

https://your-vm.runagentos.com

Open this on your phone, tablet, or any browser. No VPN, no port forwarding, no configuration.

Add to Home Screen

For an app-like experience, add AgentOS to your home screen:

iOS Safari:

Open your AgentOS URL in Safari
Tap the Share button
Scroll down and tap Add to Home Screen
Tap Add

Android Chrome:

Open your AgentOS URL in Chrome
Tap the menu (three dots)
Tap Add to Home screen
Tap Add

Now launch AgentOS like any other app—no browser chrome, full-screen experience.

Self-Hosted: Tailscale Setup

If you're running AgentOS on your own machine, use Tailscale for secure mobile access.

Why Tailscale?

No port forwarding - Works through firewalls and NAT
Encrypted - End-to-end encryption between devices
Works anywhere - Coffee shops, mobile data, hotel WiFi
Free tier - Generous free plan for personal use

Step 1: Install on Your Dev Machine

macOS:

Download from tailscale.com/download
Install and sign in (Google, GitHub, or email)
Note your Tailscale IP from the menu bar (looks like 100.x.x.x)

Linux:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4  # Note this IP

Step 2: Install on Your Phone

Download Tailscale from App Store (iOS) or Play Store (Android)
Sign in with the same account you used on your dev machine
Your dev machine should appear in the device list

Step 3: Access AgentOS

On your phone's browser, go to:

http://100.x.x.x:3011

Replace 100.x.x.x with your dev machine's Tailscale IP.

Bookmark this URL or add it to your home screen for quick access.

Mobile Browser Recommendations

Platform	Browser	Notes
iOS	Safari	Best PWA support, home screen icon
iOS	Chrome	Works well, no PWA
Android	Chrome	Full feature support, PWA capable
Android	Firefox	Good alternative

Mobile-Optimized Features

AgentOS isn't just "responsive"—it's designed for mobile as the primary device:

Bottom Navigation

Your 3 most recent sessions are always accessible in the bottom tab bar. Tap to switch instantly.

Virtual Keyboard

Three keyboard modes optimized for terminal use:

Quick Keys - Common shortcuts (Y, n, Enter, Ctrl+C, Ctrl+D)
ABC - Full alphabetic keyboard
Numbers - Numeric keypad with symbols

Touch Gestures

Swipe right on files to stage them in git panel
Swipe from left edge to open session sidebar
Pinch to zoom to adjust terminal font size
Tap anywhere on terminal to focus and show keyboard

Optimized UI

44x44px minimum touch targets
Unified diff view (fits narrow screens)
Full-screen modals instead of dropdowns
Bottom sheets for options menus

Tips for Mobile Coding

Use Quick Keys

The Quick Keys mode gives you one-tap access to:

Y / n - Answer yes/no prompts
Enter - Submit input
Ctrl+C - Cancel/interrupt
Ctrl+D - Exit/EOF
Ctrl+L - Clear screen

Pair with Bluetooth Keyboard

For extended sessions, a Bluetooth keyboard transforms the experience:

Apple Magic Keyboard
Logitech Keys-To-Go (ultra-portable)
Any compact Bluetooth keyboard

The virtual keyboard is great for quick interactions, but physical keys are better for longer work.

Enable Notifications

Turn on browser notifications to know when sessions need attention. You'll get an alert when any session enters "waiting" status—no need to keep checking.

Tap the bell icon in the header
Allow notifications when prompted
Optionally enable sound alerts