AgentOSAgentOS

AgentOS Documentation

Mobile-first web UI for managing AI coding sessions. Access Claude Code, Codex, Aider, and more from your phone.

AgentOS is a mobile-first web UI for managing AI coding assistant sessions. Built for developers who need to code on the go—not a "responsive" desktop app, but a tool designed with your phone as the primary device.

Why AgentOS?

Most AI coding tools assume you're at a desktop. AgentOS is different:

  • Primary device: Your phone (iOS/Android)
  • Primary context: On the go, away from your desk
  • Primary need: Full functionality, not a limited mobile view

Every feature works on mobile. Stage files with a swipe. Type commands with a virtual keyboard optimized for terminal use. Review diffs in a unified view that fits your screen.

What Can You Do?

Run AI Coding Sessions

Create sessions with any supported AI assistant. Each session is a full terminal with real-time status detection—know instantly when your agent needs input.

  • Claude Code - Full resume and fork support
  • Codex - OpenAI's coding agent
  • Gemini CLI - Google's Gemini models
  • Aider - AI pair programming
  • OpenCode - Multi-provider agent
  • Cursor CLI - Cursor's terminal agent

Full Git Workflow

No need to switch to a separate git client:

  • View staged, unstaged, and untracked files
  • Stage files with a tap (or swipe on mobile)
  • Review diffs with syntax highlighting
  • Commit and push directly
  • Create PRs via GitHub CLI integration
  • Browse commit history with file-level diffs

Manage Dev Servers

Start and stop your development servers from the same UI:

  • Node.js servers (npm/yarn/pnpm)
  • Docker Compose environments
  • Real-time logs and status
  • Automatic port assignment

Multi-Session Layouts

Run up to 4 sessions side-by-side on desktop. On mobile, switch between sessions with bottom tabs—your 3 most recent sessions are always one tap away.

Organize with Projects

Group related sessions into projects. Each project can have:

  • Default working directory
  • Preferred AI agent
  • Dev server templates
  • Custom settings

Getting Started

AgentOS Cloud

Get a pre-configured VM with AgentOS and Claude Code installed. No setup required.

  1. Sign up at runagentos.com
  2. Create your VM
  3. Access from any device via your secure subdomain

Self-Hosted

Run AgentOS on your own machine:

curl -fsSL https://raw.githubusercontent.com/saadnvd1/agent-os/main/scripts/install.sh | bash
agent-os start

Then set up Tailscale for secure mobile access.

Quick Links