One index, everything derived.
Each worktree is assigned a stable integer, once, and kept in a per-repo registry. Everything else falls out of it: the frontend port is 5173+N, the backend 8000+N, the log directory and the database name likewise. The mapping is sticky, so a long-lived agent keeps the same address across runs, and the primary checkout stays at index 0 holding your shared dev database while only the parallel trees fork off it. Deconflicting the database on the bare host is the part that otherwise costs a container.
It knows its own processes.
Tracking detached servers is where this gets hard. ataegina records the pid it launched together with that process’s start time, so a pid the kernel has since recycled cannot fool it into killing a stranger. Teardown enumerates the whole process tree before sending a signal, because dev servers spawn workers that never hold the socket and orphan to init if you kill only the listener. A port held by something it did not start is reported as foreign rather than assumed: up declines instead of implying success, and down leaves it alone.
Written to be driven.
Every read command speaks JSON, so a supervising agent queries state instead of parsing logs. up --wait blocks until the servers it launched actually accept connections and exits 75 if they do not, which replaces the usual sleep-and-hope loop with an exit code. list --json returns the whole fleet in one array, and doctor is read-only with a nonzero exit, so it doubles as a CI gate. It is bash 3.2 throughout, which means it runs on a stock macOS shell with nothing installed.
Apache License 2.0, with the name and logos reserved in a NOTICE file: as free to fork as before, a fork just needs its own name.