Many worktrees. No collisions.

Run several coding agents in parallel and they fight over one machine: the same ports, the same dev server, one database they stomp in unison. ataegina gives every git worktree its own ports, processes and database from a single bash file. No Docker, no daemon, no YAML.

Source on GitHub →

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.