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

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

For fresh installs without Node.js:

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

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.

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

• 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

• 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

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

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

For configuration and advanced usage, see the docs.

MIT License - Free and open source.

See LICENSE for full terms.