Matrix OS Desktop · macOS and Linux
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
Inside the app
Every view below was captured from the Matrix OS Desktop app running on the computer used to build this page.
Open developer tools, connected apps, and the software you build without losing the workspace underneath.
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
Follow these steps once. Authentication stays with each provider's own browser or device flow—no copied tokens, no laptop private keys.
Create an account, choose your compute size and region, then complete Checkout. 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.
Provisioning usually takes a few minutes. Keep the onboarding tab open, or return later and it resumes in place.
Download the latest build for Apple silicon, Intel Mac, or Linux. Open Matrix OS Desktop, choose Sign in with Matrix OS, and approve the device in the browser. The browser returns focus to the app; credentials never travel in the callback URL.
Already have a running Matrix computer? Sign in and select it—your files, sessions, and apps return immediately.
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.
gh auth login --hostname github.com --web --git-protocol sshOpen 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.
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@latestClone 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.
mkdir -p ~/projects
cd ~/projects
git clone git@github.com:owner/repo.gitOptional, highly recommended
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 guideLog in through the browser, then verify the selected computer before handing work to an agent.
brew install finnaai/tap/matrix
# or: npm install -g @finnaai/matrix
matrix login --profile cloud
matrix doctor
matrix whoamiAdds matrix-onboarding, matrix-cloud-run, and matrix-github-project to supported local agents.
curl -fsSL https://matrix-os.com/install/skills | shThe 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.
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.