Resolves stable per-app localhost ports for monorepo git worktrees.
npx skills add https://github.com/FranciscoMoretti/sparka --skill worktree-ports
Please help me install this Agent Skill. Skill: worktree-ports Source: https://github.com/FranciscoMoretti/sparka/tree/main/.agents/skills/worktree-ports Command: npx skills add https://github.com/FranciscoMoretti/sparka --skill worktree-ports
Running multiple git worktrees of the same monorepo causes port collisions between local dev servers, forcing developers to guess or hardcode ports. This Skill assigns deterministic, slot-based ports per app so every worktree gets its own non-conflicting localhost URLs.
.worktree-env.json.PORT, app URLs, and cross-app URL templates like {apps.chat.url} before the app starts.bun dev:info --json command reports the active slot and every app's resolved URL so agents never assume a port.bun dev* scripts, and each worktree serves its apps on its own port range without conflicts.Ask the agent to run bun dev:info --json and then start the chat app using the resolved worktree URL and port.
High-intent search queries and answers about installing and using this skill.
Assign each worktree a numeric slot via an environment variable, then compute ports as base plus slot times stride plus a per-app offset. This skill's scripts automate that calculation from a .worktree-env.json config file.
Run bun dev:info --json before accessing any local app. It returns the active worktree slot and each app's resolved URL and port, so you never need to assume a hardcoded port.
Start apps through the root bun dev scripts, which load .env.worktree.local and .env.local before the wrapper runs. The wrapper exports every variable declared under the app's exports, including PORT and cross-app URL templates.
Yes, use cross-app templates like {apps.chat.url} inside an app's exports in .worktree-env.json. The shared url template itself cannot reference other apps, and unknown template variables are rejected.
Offsets must be unique and below the configured range stride, and slots must be non-negative integers. Ports must also fall within 1024-65535, so privileged base ports and out-of-range offsets throw validation errors.
GolferGeekCreate, list, and remove Git worktrees with isolated ports and environment files.
mDevsLabsOrchestrate end-to-end local testing of Electron apps and chat bots.
alisonbessaManage environment variables by separating .env templates from .env.local secrets.
orient-botManage parallel Orient instances with isolated ports and Docker resources.