Worktree Ports

Discover and use stable per-app ports assigned to a local monorepo worktree. Use when starting, opening, testing, or debugging local apps, or when worktree slots, localhost ports, PORT, app URLs, or .worktree-env.json are involved.

franciscomoretti 286c9ba 5 files · 12.2 KB Updated

File contents

Worktree Ports

  • Run bun dev:info --json before accessing local apps. Use the returned app URLs; never assume a port.
  • Start apps through the root bun dev* scripts so .env.worktree.local and .env.local are loaded before the wrapper runs.
  • Set the slot environment variable declared in .worktree-env.json in a worktree-local environment file.
  • Keep app offsets unique and below the configured range stride.
  • Declare every variable an app needs under its exports, including PORT.
  • Configure cross-app environment variables with {apps.<name>.url} templates.

The generic resolver and command wrapper are bundled in scripts/.

franciscomoretti/chat-js/tree/main/.agents/skills/worktree-ports commit 286c9baf0b

Frequently asked questions

npx skillmds@latest add franciscomoretti/worktree-ports