القائمة
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 المهني
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.
| 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.