skip to content
early access · antil is not publicly available yet and commands may change · join the waitlist

the antil field manual explanation

tunnels

view markdown

Apps & urls. Git worktrees separate files. Tunnels give those worktrees separate running apps, so the checkout agent cannot take over the catalog agent’s port.

Like separate paths through a nest: each worker reaches its own app.

Parallel painted paths give each worker its own route to an app.
each worker gets its own running app.
1catalog worktreeAPI + Vite on separate ports2health check passesits own ready shop URL3checkout worktreeanother API + Vite pair4health check passesanother ready shop URL1catalog worktreeAPI + Vite on separate ports2health check passesits own ready shop URL3checkout worktreeanother API + Vite pair4health check passesanother ready shop URL
Two shop worktrees start separate API and web processes. Each passes its health check before its own browser address opens.

In the shop, each worker runs a Vite storefront and a Node API. antil picks their ports, starts the API first, and waits for its /health check. Then it starts the storefront. An app gets a live address only after antil verifies its process owns the port and its readiness check passes.

This catches an easy mistake: a server that ignores its assigned port must not borrow a successful health response from somebody else’s server.

Each app has a direct loopback address and a named local HTTP URL. Your browser or agent reads it from status --json. An ended or unready worker does not keep serving through its named URL. These addresses work on this machine; HTTPS over your private network is coming.

Tunnels use chambers for data and will give seals the running environment behind a test. The foundation keeps the same state available to a replacement agent.

Open the right app · configure the shop · pause a worker