worktree
Installation
SKILL.md
Worktrees (pnpm worktree)
Multi-instance dev environments for this monorepo. One command from a clean
checkout provisions a collision-free app stack on its own branch: unique ports
for web/api/gateway, its own node_modules + pnpm store, and a tunnel for cloud
sandbox callbacks. By default the worktree uses the primary checkout's standard
local Supabase DB (kortix-local on 54321/54322) so setup is fast and auth/data
state is shared. Pass --db only when the work needs a separate Supabase
project, schema, auth users, storage, or destructive data changes. The CLI lives
at scripts/worktree/cli.ts, run via the root package.json script
pnpm worktree.