菜单
Work on Matrix OS from inside a Matrix user VPS with near-realtime development, hot reload, previews, and safe separation between customer code and platform secrets.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | matrix-dev-vps |
| description | Work on Matrix OS from inside a Matrix user VPS with near-realtime development, hot reload, previews, and safe separation between customer code and platform secrets. |
| version | 1.0.0 |
| author | Matrix OS |
| license | MIT |
| platforms | ["linux"] |
| metadata | {"agent":{"tags":["Matrix OS","VPS","development","HMR","devops"],"related_skills":["matrix-app-builder","matrix-debug-app","matrix-integrations"]}} |
Use this when developing Matrix itself, Matrix apps, or Matrix-adjacent projects from inside a Matrix user VPS.
Matrix platform
owns Clerk, Pipedream, provisioning, shared secrets
User/dev VPS
runs gateway, shell, proxy, Postgres, app builds
contains user projects
uses cloudflared or tunnel routing for dev.matrix-os.com
From the Matrix repo:
pnpm install
pnpm --filter './packages/gateway' dev
pnpm --filter './shell' dev
For Docker-backed services, prefer the repo's documented compose file and env file:
docker compose --env-file .env -f docker-compose.dev-vps.yml up -d
For apps:
cd ~/apps/<slug>
pnpm install
pnpm build
dev.matrix-os.com should require auth.pnpm, not npm, for project dependencies.matrix user if self-update is expected.EACCES, fix ownership of the runtime node global prefix rather than running day-to-day development as root.~/apps.~/projects./health is healthy.Land a PR by monitoring conflicts, resolving them, waiting for checks, and squash-merging when green; use when asked to land, merge, or shepherd a PR to completion.
Create or continue an isolated Matrix OS worktree PR, validate it, push it, monitor CI and GitHub review feedback, iterate until the latest trusted Greptile result is 5/5, then add ready-for-ci and wait for triggered CI to pass before pinging completion. Use when asked to run a worktree to PR to monitor workflow, get a PR to Greptile 5/5 plus CI pass, or publish changes while keeping main clean.
Build Matrix OS apps as Vite React TypeScript projects with matrix.json manifests, Matrix theme integration, Postgres-backed app data, and production build verification.
The Matrix OS visual language — colors, typography, icons, animations, and component patterns. Apply this every time you build, redesign, or polish any Matrix OS surface.
Use Matrix OS platform-owned integrations from apps or agents without exposing provider secrets on customer VPSes or inside Agent.
Spin up, observe, and tear down Matrix OS preview environments — per-PR preview VPSes, platform Cloud Run preview revisions, HMR staging slots — and query their centralized logs. Use when a change needs to be seen running (shell/gateway/onboarding/CLI/macOS features), when asked to deploy a branch for testing, or when you need logs from any preview, staging, or fleet VPS.