01
Install the desktop app
Download the latest build for Apple silicon, Intel Mac, Windows, or Linux, then open Matrix OS Desktop. Desktop is the primary way to create and enter your Matrix workspace.
Guided in the app
Matrix OS Desktop · macOS, Windows, and Linux
Your cloud computer,without the browser tab.
Terminal, Chat, files, apps, Claude Code, and Codex in one desktop window—connected to a private computer that keeps running after this one sleeps.
Card required · cancel before the trial ends to avoid a charge · always-on work requires Builder or Max
Always-on computer
Shared shell sessions
Owner-controlled files
Desktop + web + CLI
Inside the app
A real desktop, not a remote-control thumbnail.
Every view below was captured from the Matrix OS Desktop app running on the computer used to build this page.
One launcher, every tool
Open developer tools, connected apps, and the software you build without losing the workspace underneath.
Sessions survive the laptop
Named Terminal sessions are shared with the web shell and CLI. Reconnect to Claude, Codex, or a dev server with its scrollback intact.
Activation guide
From download to first agent run.
Follow these steps once. Authentication stays with each provider's own browser or device flow—no copied tokens, no laptop private keys.
02
Create your account or sign in
Choose Create account or Sign in in Matrix Desktop. A secure browser window handles Clerk authentication, so the desktop app never sees your password or OAuth credentials.
Already have a Matrix computer? Sign in and select it—your files, sessions, and apps return immediately.
Guided in the app
03
Finish Checkout in your browser
Choose your compute size and region, then complete Stripe Checkout on the web. Your first primary computer starts with a 3-day free trial; a card is required and the exact first-charge date is shown before you confirm.
After provisioning, the signed approval page returns you to Matrix Desktop and opens the app. Keep the browser tab open until Desktop is in focus.
Guided in the app
04
Connect GitHub
Open Terminal in Matrix and use GitHub CLI's browser flow. Complete GitHub CLI's SSH key setup on this Matrix computer when prompted. This creates a Matrix-managed SSH key inside the runtime. Only the public key leaves your Matrix computer; the private key stays there.
Matrix terminal
gh auth login --hostname github.com --web --git-protocol ssh05
Sign in to Claude Code or Codex
Open Terminal, click +, and choose Claude Code or Codex. Matrix runs a visible installer when the tool is missing. Then run claude or codex and complete the provider-owned browser login. Do not paste API keys into chat, docs, or shared terminal output.
Matrix terminal
export MATRIX_NODE_PREFIX="${MATRIX_NODE_PREFIX:-/opt/matrix/runtime/node}"
npm install -g --prefix "$MATRIX_NODE_PREFIX" @anthropic-ai/claude-code@latest
# or
npm install -g --prefix "$MATRIX_NODE_PREFIX" @openai/codex@latest06
Bring in your first project
Clone the repository into ~/projects, then open the same named terminal from Desktop, the web shell, or the Matrix CLI. The process stays on your Matrix computer when this laptop sleeps.
Matrix terminal
mkdir -p ~/projects
cd ~/projects
git clone git@github.com:owner/repo.gitOptional, highly recommended
Give your local agents the keys to Matrix.
The desktop app is enough to work. The CLI and Matrix skills make it much easier to reconnect from a local terminal, run observable jobs, and migrate active projects safely.
Read the Matrix skills guide1. Install and verify the CLI
Log in through the browser, then verify the selected computer before handing work to an agent.
Local terminal
brew install finnaai/tap/matrix
# or: npm install -g @finnaai/matrix
matrix login --profile cloud
matrix doctor
matrix whoami2. Install the Matrix skills pack
Adds matrix-onboarding, matrix-cloud-run, and matrix-github-project to supported local agents.
Local terminal
curl -fsSL https://matrix-os.com/install/skills | sh3. Hand off an active project
The optional matrix-handoff skill creates a filtered preview and approval token before upload. It refuses changed scopes and never copies local credentials, private keys, .env files, dependencies, or build output.
Local terminal
pnpm dlx skills@1.5.23 add https://github.com/HamedMP/matrix-os/tree/main/.agents/skills/matrix-handoff --global --allStart a new agent session, then ask: Use $matrix-handoff to move this project to Matrix with Codex.
Your computer stays yours