Durable identity
Files, workspaces, cookies, site data, local storage, preferences, sessions, and browser history survive restarts and supported upgrades.
Open source. Local first. Model agnostic.
Qubicl runs locally with Docker and gives AI agents durable Linux computers with files, terminal access, browser automation, desktop applications, human observation, and takeover. Works with Codex, Claude, OpenCode, OpenClaw, Hermes, Open WebUI, Cursor, VS Code, and other compatible agents and clients.
$ npm install -g qubicl-cli
Apache 2.0 · No Qubicl account required
agent@research:~/project$ npm run build
✓ 42 modules transformed.
✓ built in 1.24s
agent@research:~/project$
Persistent by design
The computer owns its durable home, Chromium profile, network policy, tools, credentials, and runtime configuration. Agents are temporary. The computer is not.
Files, workspaces, cookies, site data, local storage, preferences, sessions, and browser history survive restarts and supported upgrades.
Compatible clients can reconnect to the same computer and continue with its existing home, browser profile, policy, tools, and credentials.
Create separate computers when agents, clients, projects, or users should not share persistent identity and state.
Manage resources, network access, tools, skills, credentials, and lifecycle from the CLI or local dashboard. Review changes before approving them.
Shared computer state
Codex, Claude, OpenCode, OpenClaw, Hermes Agent, Open WebUI, Cursor, VS Code, and other compatible clients can continue work in the same Qubicl computer. A new client does not mean a new home or isolated session.
Explore client connectionsYour files.
Your browser.
Your policy.
The agent gets a computer, not your machine.Progressive presets
Every preset starts with a durable home, terminal access, Git, managed processes, and local web research. Browser-capable presets add a durable Chromium profile. Images are acquired lazily and share layers across presets.
01
Headless shell, processes, Git, durable files, and web research.
02
Persistent Chromium profile, OCR, screenshots, and PDF inspection.
03
Browser plus a lightweight XFCE desktop, editors, document tools, and SSH.
04
Development and office workflows with supported Writer, Calc, and Impress applications.
Local management
Create computers, adjust resources, manage tools and network access, and review backups and updates from a local dashboard. See what will change before you approve it, then follow the operation through completion or recovery.
Explore the dashboardCheck lifecycle state, resources, exposed tools, network policy, skills, and scoped credentials.
See effects and interruptions before a change runs. Sensitive actions ask for your password again.
Create backups, checkpoints, and clones without turning the computer into a disposable session.
Operation history survives restarts and keeps ambiguous results available for local review.
Optional setup
The dashboard is available on native Linux x64 and Apple Silicon macOS. Set the administrator password in your terminal, then finish setup in the browser.
Human takeover
The live viewer is passive until you act. Viewer-capable computers authenticate internal noVNC traffic, and raw VNC is never exposed. Take control and Qubicl fences agent tools while the durable browser profile and managed desktop applications remain visible.
Four steps
Install the Qubicl command-line tool from npm.
npm install -g qubicl-cliThe wizard validates local Docker, compares presets, previews resource and image effects, obtains the selected computer image and gateway, and can create the first computer.
qubicl setupName the workspace and select the preset that better supports the job.
qubicl create computer-name --preset computerGenerate setup instructions for a compatible client. Other clients can later reconnect to this same computer and continue its existing state.
qubicl connect computer-name --client open-webuiExplicit trust boundaries
Agents connected to the same Qubicl computer share its persistent home, browser profile, network policy, tools, credentials, and runtime configuration. Disconnecting an agent does not reset that state or create a security boundary.
Separate what should not trust: Create different computers for agents, clients, projects, or users that should not share state. Qubicl is designed for trusted or operator-supervised work. Its Docker containers are not a VM boundary for deliberately hostile code.
Administration stays with the host owner. The dashboard previews changes before approval and requires password confirmation for sensitive actions. Optional private HTTPS administration is configured separately from remote agent and viewer access. Both are off by default.
Read the security modelReleases
Qubicl 0.5 adds local management, private administration, and more resilient recovery. Explore the release and the upgrade guide for existing computers.
A dashboard for your computers, optional private HTTPS administration, and recoverable operations that preserve durable state.
Read the 0.5 release notesBrowse current and historical release notes, upgrade guidance, support status, and known limitations.
View all releasesPlatform support · Qubicl 0.5
Core Qubicl supports Linux x64, Apple Silicon macOS with Docker Desktop, and Windows 11 x64 through Ubuntu 24.04 on WSL 2 with Docker Desktop. Every Qubicl computer runs Linux.
Management dashboard: Available on native Linux x64 and Apple Silicon macOS. Windows through WSL 2 uses the CLI.
Requires Node.js 22.14+ or 24.x, Docker Engine 24+ or Docker Desktop 4.29+, and Docker Compose 2.24+. Run as your normal user. Start Docker before setup.
Linux ARM64, Intel macOS, Windows on ARM, and other WSL 2 distributions are best effort for core Qubicl. Native Windows and WSL 1 are unsupported.
On Windows 11, install Ubuntu 24.04 under WSL 2 and enable Docker Desktop’s WSL integration. Install and run Qubicl inside Ubuntu. Keep Qubicl state and computer homes in the Linux filesystem under /home, not on a mounted Windows drive.
Support policy and release testing are distinct. See the release-specific testing scope and the platform guide.