CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

65

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/worktree-ports/SKILL.md
SKILL.md
Quality
Evals
Security

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/.

Repository
FranciscoMoretti/chat-js
Path

.agents/skills/worktree-ports/SKILL.md

Commit

f66626f

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill