Launch App

SkillAI & models

Launch Matrix OS runtime surfaces for validation. Use when Symphony agents need runtime checks for shell, gateway, platform, or bundled app changes in this repo.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Launch App skill

What this skill tells your AI

The instructions your AI receives, as published by hamedmp/matrix-os in .agents/skills/launch-app/SKILL.md and read by ahel’s review.

Local Runtime

Matrix OS uses bun for scripts and pnpm for installs.

pnpm install --frozen-lockfile
bun run dev

This starts gateway, proxy, and shell together. For narrower checks:

bun run dev:gateway
bun run dev:shell
bun run dev:platform

Bundled Default Apps

First-party apps live under home/apps/** and build to dist/.

node scripts/build-default-apps.mjs home/apps

For one app, run its own build from the app directory:

pnpm --dir home/apps/symphony install
pnpm --dir home/apps/symphony build

Validation

  • Canvas is the primary shell surface; verify user-visible shell changes there first.
  • Built-in app paths must work in Canvas and Desktop.
  • For bundled apps, verify dist/index.html exists before handoff.
  • Public website changes are validated in the private FinnaAI/matrix-os-site repository.
  • Run the relevant targeted tests, then the repo gates when scope warrants:
    bun run typecheck
    bun run check:patterns
    bun run test
    

Signals

GitHub stars
64
Forks
20
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
launch-app
Source
github.com/hamedmp/matrix-os