# Matrix OS Documentation

> Matrix OS is an AI-native operating system where software is generated from conversation.

- [CLI](/docs/cli): Install and use the matrix CLI to log in, run agents, sync files, forward ports, and manage shell sessions on your Matrix computer.
- [Coding Agents](/docs/coding-agents): Install and run coding agents on your Matrix computer.
- [Desktop App (Operator)](/docs/desktop): The native macOS app for Matrix OS — projects, tasks, agent threads, terminals, and apps in one keyboard-first window.
- [Glossary](/docs/glossary): Plain-language definitions of the words used throughout the Matrix OS docs.
- [Hermes and OpenClaw](/docs/hermes): Configure an optional messaging runtime for Telegram, WhatsApp, and other connected channels.
- [Matrix OS](/docs): Your cloud coding computer for developers who run AI coding agents.
- [Matrix Skills](/docs/matrix-skills): Understand and install the three Matrix skill sets for local agents, Matrix computers, and Matrix OS contributors.
- [Messages](/docs/messages): Connect Telegram and WhatsApp to Matrix OS with private, room-level AI controls.
- [Mobile](/docs/mobile): Access your Matrix computer from iPhone or Android with the native Matrix OS app.
- [Onboarding Launch Readiness](/docs/onboarding-launch-readiness): How Matrix prepares a founder or developer workspace before paid access is enabled.
- [Quickstart](/docs/quickstart): Go from zero to a running Matrix computer with a working shell in under ten minutes.
- [Self-host](/docs/self-host): Install Matrix OS on your own Linux VPS with the main-domain server installer.
- [Settings & Billing](/docs/settings-billing): Manage your plan, compute tier, region, and billing portal after signup.
- [Web Shell](/docs/shell): The primary interface to your Matrix computer, available at app.matrix-os.com.
- [Symphony](/docs/symphony): Run Linear tickets through the Matrix-owned Elixir Symphony service.
- [Workspace Canvas](/docs/workspace-canvas): Spatial PR, terminal, and review-loop workspaces in Matrix OS.
- [Agent System](/docs/guide/agents): The five core agents, SOUL identity, custom agents, and the skills system.
- [App Store](/docs/guide/app-store): Browse, install, publish, and fork apps. Public app links, personal websites, and the skills store.
- [Apps](/docs/guide/apps): Use built-in apps and ask Matrix to create new apps for your work and life.
- [Multi-Channel Support](/docs/guide/channels): Use Matrix OS through the web workspace and connected messaging surfaces.
- [CLI](/docs/guide/cli): The matrix CLI — log in, sync files, attach to remote zellij sessions, and drive your instance from the terminal.
- [Cloud Coding](/docs/guide/cloud-coding): Project workspaces, GitHub authentication, Browser IDE access, review loops, and sandboxed coding agents.
- [Design System](/docs/guide/design-system): CSS variables, color palette, typography, components, and visual language for Matrix OS apps.
- [Developer Workflow](/docs/guide/developer-workflow): Use Matrix OS as the persistent workspace for Claude Code, Codex, Cursor, Copilot, Gemini CLI, Cline, Jules, Devin, and other coding agents.
- [File System](/docs/guide/file-system): The home directory, config, themes, git snapshots, and the "Everything Is a File" philosophy.
- [Getting Started](/docs/guide/getting-started): Sign up, open your Matrix workspace, connect your tools, and make your first useful request.
- [Guide](/docs/guide): Learn what Matrix OS can do and how to use it day to day.
- [Integrations](/docs/guide/integrations): Connect external services like Gmail, Google Calendar, GitHub, Slack, and Discord to Matrix OS.
- [Mobile](/docs/guide/mobile): Use Matrix OS from a phone without starting in the desktop Canvas.
- [Social](/docs/guide/social): Social feed, follow system, messaging, Matrix protocol federation, and external platform connections.
- [Storage](/docs/guide/storage): Where your Matrix files, app data, memories, and workspace state live.
- [Activity Monitor](/docs/guide/system-activity-monitor): Inspect your Matrix computer, resource usage, service health, processes, and safe cleanup suggestions.
- [Agent Matrix Skills](/docs/developer/agent-skills): Canonical Matrix skill pack for supported coding agents.
- [Architecture](/docs/developer/architecture): How Matrix OS fits together: platform control plane, customer VPS runtime, gateway, shell, kernel, apps, and data.
- [Browser Automation](/docs/developer/browser-automation): Persistent browser profiles and the Matrix OS browser MCP tool.
- [Contributing](/docs/developer/contributing): How to set up, develop, and contribute to Matrix OS.
- [Dev VPS](/docs/developer/dev-vps): Develop Matrix OS inside a user or developer VPS.
- [Contributor Overview](/docs/developer): Technical reference for building on, operating, and contributing to Matrix OS.
- [IPC Tools & Hooks](/docs/developer/ipc-tools): The 26 IPC tools, hook lifecycle, and permission model.
- [Logging & Usage](/docs/developer/logging): Kernel operation logging, token tracking, usage API, file audit trail, and log rotation.
- [Releases](/docs/developer/releases): Host bundles, channels, and customer VPS updates.
- [Review Pipeline](/docs/developer/review-pipeline): Pre-PR checks and review passes for Matrix OS changes.
- [Skills System](/docs/developer/skills): Skill validation, caching, composable skills, domain-specific app skills, and build pipeline optimization.
- [Testing](/docs/developer/testing): Test-driven development, running tests, coverage targets, and test structure.
- [Billing](/docs/developer/deployment/billing): Stripe-hosted runtime plans, entitlements, and operator setup.
- [VPS-per-User](/docs/developer/deployment/vps-per-user): Operator notes for customer VPS provisioning, backup, and recovery.

## Blog

- [How to stop parallel coding agents fighting over ports and databases](/blog/avoid-parallel-agent-port-database-conflicts): Isolate ports, databases, containers, caches, and test artifacts when Claude Code, Codex, and other agents run in parallel.
- [Best cloud development environments for AI coding agents](/blog/best-cloud-dev-environments-for-ai-agents): A practical framework for comparing persistent computers, cloud IDEs, task sandboxes, Codespaces, Coder, Daytona, VPS setups, and Matrix OS.
- [Claude Code remote options: Remote Control vs web vs VPS vs Matrix OS](/blog/claude-code-remote-options): Compare the main ways to run or control Claude Code remotely, including laptop requirements, persistence, setup, and best use cases.
- [Git worktrees for AI coding agents: a practical guide](/blog/git-worktrees-for-coding-agents): Give Claude Code, Codex, and other agents isolated working directories and branches without cloning the repository repeatedly.
- [Grok Bot vs Matrix OS: closed agent stack or open-source computer?](/blog/grok-bot-vs-matrix-os): Compare closed Grok Bot with open-source Matrix OS for persistent agents, coding workflows, model choice, multi-agent orchestration, and self-hosting.
- [How to keep Codex CLI running after you close your laptop](/blog/keep-codex-running): Run Codex CLI on a persistent remote computer so terminal work continues after your laptop sleeps or disconnects.
- [Matrix OS vs GitHub Codespaces for AI coding agents](/blog/matrix-os-vs-github-codespaces): Compare Matrix OS and GitHub Codespaces for cloud development, persistent processes, repositories, agent CLIs, idle shutdown, and ongoing workspaces.
- [Matrix OS vs a VPS for AI coding agents](/blog/matrix-os-vs-vps): Compare Matrix OS with a raw VPS for persistent coding agents across setup, access, terminals, security, maintenance, and control.
- [How to run Claude Code and Codex in parallel](/blog/run-claude-code-and-codex-in-parallel): Use Claude Code and Codex together with isolated worktrees, bounded responsibilities, independent runtimes, and one review queue.
- [How to run Claude Code on a VPS](/blog/run-claude-code-on-vps): Install Claude Code on a remote Linux server, keep it alive with a persistent terminal, secure access, and reconnect after your laptop closes.
- [How to run Claude Code overnight safely](/blog/run-claude-code-overnight-safely): Use scoped tasks, isolated branches, least privilege, checkpoints, and review gates for safer unattended Claude Code sessions.
- [How to run Gemini CLI remotely on an always-on computer](/blog/run-gemini-cli-remotely): Run Gemini CLI on a persistent cloud computer, reconnect from any device, and avoid unsafe credential and terminal setups.
- [How to run multiple Claude Code sessions in parallel](/blog/run-multiple-claude-code-sessions): Run parallel Claude Code sessions without agents overwriting files, sharing branches, or fighting over ports and databases.
- [How to run OpenCode on a VPS](/blog/run-opencode-on-vps): Install OpenCode on a remote Linux server, configure a model provider safely, and keep sessions available after disconnecting.
- [How to use Claude Code from your phone](/blog/use-claude-code-from-phone): Start, monitor, and resume Claude Code work from a phone without leaving your laptop awake or exposing an insecure terminal.
- [Agents need a computer, not another chat box](/blog/cloud-computer-for-agents): Why Matrix OS treats background AI work as an operating-system problem: persistent files, terminals, apps, previews, and human control.
- [How to keep Claude Code running after you close your laptop](/blog/keep-claude-code-running-after-laptop-closes): Run Claude Code in a persistent cloud computer so agent sessions keep working after your laptop sleeps, disconnects, or runs out of battery.
- [Web 4 is an operating system](/blog/web4-operating-system): A practical definition of Web 4: AI as the kernel, files as memory, and every interface as a shell over the same durable computer.
- [Canvas first, desktop still matters](/blog/canvas-first-workspace): How Matrix OS thinks about the shell: a spatial canvas for active work, with desktop compatibility where familiar windowing still helps.