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.
Installs into .claude/skills of the current project.
Are you the author of Worktree Ports?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/franciscomoretti-worktree-ports)
---
name: worktree-ports
description: 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.
---
# 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/`.
