Worktree Ports
SkillDev toolsDiscover 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Worktree Ports skill
What this skill tells your AI
The instructions your AI receives, as published by franciscomoretti/chat-js in .agents/skills/worktree-ports/SKILL.md and read by ahel’s review.
- Run
bun dev:info --jsonbefore accessing local apps. Use the returned app URLs; never assume a port. - Start apps through the root
bun dev*scripts so.env.worktree.localand.env.localare loaded before the wrapper runs. - Set the slot environment variable declared in
.worktree-env.jsonin a worktree-local environment file. - Keep app offsets unique and below the configured range stride.
- Declare every variable an app needs under its
exports, includingPORT. - Configure cross-app environment variables with
{apps.<name>.url}templates.
The generic resolver and command wrapper are bundled in scripts/.
Signals
- GitHub stars
- 1k
- Forks
- 122
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
worktree-ports- Source
- github.com/franciscomoretti/chat-js