AgentOSAgentOS

Quick Start

Get started with AgentOS Cloud in under 2 minutes.

Get coding with AI assistants from any device in minutes.

AgentOS Cloud

The fastest way to get started. We provision a VM with AgentOS and Claude Code pre-installed.

Step 1: Sign Up

Go to runagentos.com/dashboard and create an account.

Step 2: Create Your VM

Click Create VM to provision your cloud instance. This takes about 60 seconds.

Step 3: Access Your VM

Once ready, you'll get a secure subdomain like your-vm.runagentos.com. Open it from any device—phone, tablet, or laptop.

Step 4: Start Coding

  1. Click + New Session in the sidebar
  2. Select an AI agent (Claude Code is default)
  3. Choose a working directory (or create a new project)
  4. Start chatting with your AI assistant

That's it. Your sessions persist across devices and browser refreshes.

Self-Hosted Install

Prefer to run on your own machine? Here's how.

Requirements

  • Node.js 20+
  • tmux installed
  • At least one AI coding CLI (Claude Code recommended)

One-Line Install

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

This:

  • Installs prerequisites if missing
  • Prompts to install an AI CLI if none detected
  • Builds and configures AgentOS
  • Adds agent-os command to your PATH

Start AgentOS

agent-os start

Open http://localhost:3011 in your browser.

CLI Commands

agent-os run       # Start and open browser
agent-os start     # Start in background
agent-os stop      # Stop server
agent-os restart   # Restart server
agent-os status    # Show status and URLs
agent-os logs      # Tail server logs
agent-os update    # Update to latest version

Mobile Access (Self-Hosted)

To access from your phone, set up Tailscale:

  1. Install Tailscale on your dev machine and phone
  2. Sign in with the same account on both
  3. Access AgentOS at http://100.x.x.x:3011 (your Tailscale IP)

See Mobile Access for detailed setup.

Your First Session

Whether cloud or self-hosted, creating your first session is the same:

  1. Click + New Session in the sidebar
  2. Select your AI agent - Claude Code has the most features (resume, fork)
  3. Choose a directory - Browse to your project folder
  4. Optional: Enable worktree - Creates an isolated git branch for this session
  5. Click Create

Your terminal opens and the AI agent starts. Type your first prompt and start coding.

What's Next?