AgentOS

A mobile-first web UI for managing AI coding sessions.

https://github.com/user-attachments/assets/0e2e66f7-037e-4739-99ec-608d1840df0a

Installation

Via npm (Recommended)

If you already have Node.js 20+ installed:

# Install globally
npm install -g @saadnvd1/agent-os

# Run setup (checks/installs tmux, ripgrep, builds app)
agent-os install

# Start the server
agent-os start

Via curl (Installs everything)

For fresh installs without Node.js:

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

Desktop App

Download native desktop apps from Releases:

• macOS (Apple Silicon): .dmg
• Linux: .deb or .AppImage

Note: The desktop app is a native wrapper around the web UI. You still need to install and run AgentOS (via the installer script above) for the backend server. The desktop app just provides a convenient native window instead of using your browser.

Don't want to self-host? Try AgentOS Cloud - pre-configured cloud VMs for AI coding.

Manual Install

git clone https://github.com/saadnvd1/agent-os
cd agent-os
npm install
npm run dev  # http://localhost:3011

Prerequisites

• Node.js 20+
• tmux
• ripgrep (for code search - auto-installed by installer script, or run agent-os update)
• At least one AI CLI: Claude Code, Codex, OpenCode, Gemini CLI, Aider, or Cursor CLI

Supported Agents

| Agent | Resume | Fork | Auto-Approve | | ----------- | ------ | ---- | -------------------------------- | | Claude Code | ✅ | ✅ | --dangerously-skip-permissions | | Codex | ❌ | ❌ | --approval-mode full-auto | | OpenCode | ❌ | ❌ | Config file | | Gemini CLI | ❌ | ❌ | --yolomode | | Aider | ❌ | ❌ | --yes | | Cursor CLI | ❌ | ❌ | N/A |

Features

• Mobile-first - Full functionality from your phone, not a dumbed-down responsive view
• Multi-pane layout - Run up to 4 sessions side-by-side
• Code search - Fast codebase search with syntax-highlighted results (Cmd+K)
• Git integration - Status, diffs, commits, PRs from the UI
• Git worktrees - Isolated branches with auto-setup
• Dev servers - Start/stop Node.js and Docker servers
• Session orchestration - Conductor/worker model via MCP

CLI Commands

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

Mobile Access

Use Tailscale for secure access from your phone:

1. Install Tailscale on your dev machine and phone
2. Sign in with the same account
3. Access http://100.x.x.x:3011 from your phone

Documentation

For configuration and advanced usage, see the docs.

License

MIT License - Free and open source.

See LICENSE for full terms.