GitHub - saadnvd1/agent-os: Mobile-first web UI for managing AI coding sessions (Claude Code, Codex, Aider, Gemini CLI). Self-hosted with multi-pane terminals, git integration, and session orchestration.

AgentOS

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

agent-os-mobile-demo.mp4

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:

Install Tailscale on your dev machine and phone
Sign in with the same account
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.