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, Kilo Code CLI, 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
Kilo Code	✅	✅	Config file
Gemini CLI	❌	❌	--yolomode
Aider	❌	❌	--yes
Cursor CLI	❌	❌	N/A
Amp	❌	❌	--dangerously-allow-all
Pi	❌	❌	N/A
Oh My Pi	❌	❌	N/A

Features

• Mobile-first - Full functionality from your phone, not a dumbed-down responsive view
• Voice-to-text - Dictate prompts to your coding sessions hands-free
• Multi-pane layout - Run up to 4 sessions side-by-side
• Code search - Fast codebase search with syntax-highlighted results (Cmd+K)
• File picker - Browse and attach files to sessions, with direct upload from mobile
• Clone from GitHub - Clone repos directly from the UI when creating projects
• 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.

Related Projects

• aTerm - A Tauri-based desktop terminal workspace for AI-assisted coding. While AgentOS is a mobile-first web UI, aTerm is a native desktop app with multi-pane layouts optimized for running AI coding agents (Claude Code, Aider, OpenCode) alongside shells, dev servers, and a built-in git panel. Choose AgentOS for mobile access and browser-based workflows, or aTerm for a native desktop terminal experience.
• LumifyHub - Team collaboration platform with real-time chat and structured documentation. Useful alongside AgentOS for coordinating multi-agent work across a team — share session context, document architectural decisions from coding sessions, and track progress across parallel agent workflows.

License

MIT License - Free and open source.

See LICENSE for full terms.