An open-source Agent Computer providing a shared desktop environment for humans and AI Agents, with persistent memory and cross-session continuity.
holaOS redefines the computer as a shared environment for humans and AI Agents, where Agents have equal access to browsers, file systems, and applications.
Core Features#
- Shared Human-Agent Environment: Humans and AI Agents operate the same browsers, files, and applications in parallel with equal permissions, breaking traditional Agent sandbox isolation
- Memory & Continuity: Persistent memory that survives across sessions; continuity artifacts and long-horizon recovery; Agents continuously run and evolve over time
- Workspace Model: Creation, switching, and management of workspaces; disk representation and contract-based workspace conventions; runtime-owned state management
- Agent Framework & Customization: Agent Harness defines stable framework boundaries and executor embedding; role and template system for consistent, reproducible workflows
- Deployment Flexibility: Desktop app mode (Electron, macOS / Linux / WSL); portable runtime for headless independent operation
- Protocols & Ecosystem: MCP (Model Context Protocol) support; application ecosystem with Marketplace BFF layer; Runtime APIs covering workspace, run, streaming, and app lifecycle
System Architecture#
The system uses a layered design:
| Layer | Directory | Responsibility |
|---|---|---|
| Desktop | desktop/ | Electron desktop app frontend, shadcn/ui + Base UI components |
| Runtime | runtime/ | Core runtime engine (TypeScript), handling workspace, run, streaming, app lifecycle |
| SDK | sdk/ | runtime-client SDK + BFF bridge + browser-pane scaffolding |
| Docs | docs/ | MDX internal technical documentation |
| Scripts | scripts/ | Install/deploy scripts, Node version pinned to 24.14.1 |
| Website | website/docs/ | Official documentation site |
Core Concepts: Environment Engineering (environment definition system), Workspace Model (contracts, authored surfaces, runtime state), Memory & Continuity, Agent Harness, Runtime APIs.
Installation & Quick Start#
Prerequisites: git, Node.js, npm
One-click install (macOS / Linux / WSL):
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/main/scripts/install.sh | bash -s -- --launch
Manual install:
git clone https://github.com/holaboss-ai/holaOS.git
cd holaOS
npm run desktop:install
cp desktop/.env.example desktop/.env
npm run desktop:prepare-runtime:local
npm run desktop:typecheck
npm run desktop:dev
Installation commands can be handed directly to coding Agents (Claude Code, Cursor, Windsurf, etc.) for automated environment setup.
Use Cases#
- Delegating daily digital work (browser ops, file management, app usage) to AI Agents
- Long-running tasks requiring cross-session memory and state persistence
- Development environments integrating Codex, Claude Code, Cursor, Windsurf and other coding Agents
- Building custom Agent applications and templates on top of holaOS Workspaces
Unconfirmed Information#
- Full LLM Provider support list not publicly disclosed
- Cloud-hosted service exists (Sign-in on holaos.ai) but features and pricing are unconfirmed
- MCP integration specifics and adapted tool list not detailed
- Runtime API signatures and call examples not expanded in public docs
- Non-coding scenario Agent capabilities lack concrete demos or case studies