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:

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.