Files
seedit/scripts/AGENTS.md
Tommaso Casaburi 6159ee1ede fix(dev server): avoid portless route collisions
Adopt branch-aware Portless app naming with numeric suffixes for repeated worktree runs, add a shared direct-Vite port resolver for PORTLESS=0, and keep the Electron bypass pinned to PORT=3000 so existing localhost-based dev flows still work.
2026-03-31 19:41:27 +07:00

1.0 KiB

scripts/AGENTS.md

These rules apply to scripts/**. Follow the repo-root AGENTS.md first, then use this file for automation and workflow helpers.

  • Keep scripts non-interactive and idempotent. Print the command, URL, branch, or path being acted on so failures are diagnosable.
  • Use repo-relative paths and environment variables instead of user-specific absolute paths.
  • For dev-server helpers, default to http://seedit.localhost:1355, but allow a branch-scoped *.seedit.localhost:1355 route when the launcher is avoiding a Portless name collision. Respect the existing PORTLESS=0 fallback instead of hard-coding alternate ports. If a flow intentionally bypasses Portless, override AGENT_APP_URL explicitly.
  • Keep shell helpers thin. When logic becomes stateful or cross-platform, prefer a Node script.
  • Git and worktree helpers must validate input and default to safe operations.
  • If a helper deletes local branches automatically, document the exact eligibility checks and keep the behavior conservative.