Your cloud computer for AI agents, apps, terminals, files, and integrations.
Website · Docs · Whitepaper · Agent setup · DeepWiki · Discord · X
Matrix OS gives you a hosted cloud computer: browser desktop, files, terminal sessions, apps, integrations, messages, and AI agents running on your personal VPS. Open any browser, sign in, and your workspace is there. Install the Matrix CLI and Claude, Codex, GitHub CLI, or Hermes can attach to the same machine.
It is not a chat box beside your software. The AI is the kernel. The shell, gateway, files, apps, terminal, channels, and agents are one operating environment.
Most AI products leave your work scattered across chats, terminals, dashboards, and local machines. Matrix OS gives agents a persistent place to work.
| You need | Matrix OS gives you |
|---|---|
| A real workspace for AI agents | A hosted personal VPS with browser shell, terminal sessions, files, apps, and logs |
| Software without waiting on a SaaS roadmap | Apps generated from natural language and saved as inspectable projects |
| Continuity across devices | One cloud desktop reachable from the web, Matrix CLI, and messaging channels |
| Data you can leave with | Owner-controlled files plus Postgres for durable app and workspace data |
| A system that can improve itself | Agents, skills, hooks, cron jobs, and self-healing workflows |
Matrix OS is the foundation for Web 4: a unified environment where operating system, messaging, social identity, apps, games, files, and AI agents are one system.
Start at the landing page: matrix-os.com.
Sign up or log in from there, choose a Matrix handle, provision your private runtime, and open the browser desktop. Hosted Matrix OS uses a platform control plane plus one VPS-native runtime per active user. That VPS is where your files, terminal sessions, generated apps, integrations, and coding agents live.
Install the CLI:
# macOS or Linux with Homebrew
brew install finnaai/tap/matrix
# Or with npm
npm install -g @finnaai/matrix
# Or with the install script
curl -fsSL https://get.matrix-os.com | shLog in from the CLI and inspect your instance:
matrix login
matrix whoami
matrix status
matrix instance infomatrix login opens a browser/device flow against the hosted Matrix cloud. If it says no Matrix instance exists yet, sign up at matrix-os.com, finish provisioning, then run matrix login again.
Agents should read the public skill file and follow it:
https://matrix-os.com/skills.md
Install the skill locally if your agent runtime supports file skills:
npx skills add HamedMP/matrix-os --skill matrix-osThen use Matrix shell sessions for remote work:
# Bring your own terminal agent.
matrix run -it -- claude
matrix run -it -- codex
# Use a named setup session so the web terminal and local CLI can reattach.
matrix run -it --session setup -- gh auth login
matrix run -it --session setup -- claude
matrix run -it --session setup -- codex
matrix shell attach setupDetach from an interactive session with Ctrl-\ Ctrl-\. The remote zellij session stays alive and can be reattached from the Matrix web terminal or CLI. This is the same computer the hosted browser shell shows.
Use the source install when contributing to Matrix OS itself:
git clone https://github.com/HamedMP/matrix-os.git
cd matrix-os
flox activate
bun run devWithout Flox, install Node.js 24+, pnpm 10, and bun, then run:
pnpm install
bun run devDevelopment services:
bun run dev:gateway # Hono gateway
bun run dev:shell # Next.js shell
bun run dev:proxy # Shared API proxy
bun run dev:platform # Multi-tenant platform
bun run dev:www # matrix-os.com website| Generate apps | Describe a tool in plain English. Matrix creates a working app, saves it as files, and opens it in the shell. |
| Run a browser desktop | Canvas-first web shell with windows, dock, app launcher, wallpapers, terminal, file browser, and generated apps. |
| Keep agent work persistent | Projects, terminals, task context, logs, app state, and workspace state survive across sessions and devices. |
| Talk through channels | Reach the same kernel through web, CLI, Telegram, WhatsApp, Discord, Slack, Matrix protocol, and voice surfaces as they are enabled. |
| Connect services | Pipedream Connect integration for Gmail, Slack, GitHub, and 2,400+ services with OAuth-managed settings. |
| Automate on schedule | Cron jobs, heartbeat workflows, proactive tasks, and scheduled agent runs. |
| Heal and expand | Specialized agents can diagnose failures, repair files, add skills, and grow new capabilities. |
| Own your data | Identity and configuration are files. App and workspace data live in owner-controlled Postgres, not an opaque platform database. |
Watch the original Matrix OS demo.
Built for the Anthropic "Built with Opus 4.6" Hackathon in February 2026, where Matrix OS placed in the top 20.
Matrix OS at the Claude Code Birthday Party at Anthropic HQ.
Web shell / CLI / Telegram / WhatsApp / Discord / Slack / Matrix / Voice
|
v
Hono Gateway + WebSocket bus
REST, terminal, files, messages, apps, cron, metrics
|
v
Dispatcher -> AI Kernel (Claude Agent SDK V1)
|
Builder / Researcher / Deployer / Healer / Evolver agents
|
v
Owner-controlled files + Postgres + generated apps + integrations
The OS metaphor is literal:
| Computer concept | Matrix OS equivalent |
|---|---|
| CPU | Frontier model routing, currently Claude Opus 4.6 |
| Kernel | Main Agent SDK V1 query() loop with resume |
| Processes | Specialized sub-agents with isolated context |
| Disk | Matrix home files plus owner-controlled Postgres |
| System calls | MCP and gateway IPC tools |
| Drivers | Channel adapters, integrations, browser, terminal, voice |
| Shell | Next.js desktop/canvas UI, CLI, and messaging surfaces |
| Layer | Technology |
|---|---|
| Language | TypeScript 5.5+ strict, ES modules |
| Runtime | Node.js 24+ |
| AI | Claude Agent SDK V1 query() + resume, Opus 4.6 |
| Frontend | Next.js 16, React 19, Turbopack, React Compiler |
| Backend | Hono HTTP/WebSocket gateway |
| Database | PostgreSQL via Kysely |
| Validation | Zod 4 via zod/v4 |
| Terminal | node-pty, xterm.js, WebGL renderer |
| Integrations | Pipedream Connect |
| Observability | Prometheus metrics |
| Testing | Vitest, @vitest/coverage-v8 |
| Package manager | pnpm for install, bun for scripts |
packages/kernel/ AI kernel, agents, hooks, SOUL, skills
packages/gateway/ Hono HTTP/WS gateway, channels, cron, terminal, voice
packages/platform/ Hosted control plane, auth, provisioning, routing
packages/proxy/ Shared API proxy and usage tracking
packages/ui/ Shared UI components
shell/ Next.js desktop and canvas shell
www/ matrix-os.com and public docs
home/ Matrix home template copied on first boot
specs/ Architecture and feature specs
tests/ Vitest suites
docs/ Developer and operations docs
Run the core checks before opening a PR:
bun run typecheck
bun run check:patterns
bun run testOther useful commands:
bun run test:watch
bun run test:integration
bun run test:coverage
bun run test:e2eDocker commands are available for local legacy development, but production Matrix OS is VPS-native per user. Customer runtime updates ship as host bundles, not rolling Docker image restarts.
Matrix OS is live at matrix-os.com, with hosted runtime provisioning, a canvas-first shell, file browser, terminal, generated apps, onboarding, integrations, observability, docs, and the early Web 4 foundation in place.
Current focus areas:
- Paid beta readiness and production polish
- Canvas workspace and cloud coding workflows
- Mobile shell
- Matrix messaging bridge for Telegram and WhatsApp
- SDK-native skills and agent-readable setup
See:
Matrix OS. Software that does not exist until you need it. Once it does, it is yours.