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:
.debor.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 |
| 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:
- Install Tailscale on your dev machine and phone
- Sign in with the same account
- Access
http://100.x.x.x:3011from 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.