lightsout queue
Drain the tracker of automatable tickets in parallel worktrees, relaying any question to this terminal or to a mailbox directory.
When to reach for it
Run it when the tracker holds tickets you have labelled for automation and you want them built without picking them up one at a time: it makes a worktree and branch per ticket, runs the worker its label names, puts any question it cannot answer to this terminal — or, with `--file-relay`, to a mailbox directory an agent session or an editor can answer from — then ships the ready branches one at a time, each rebased onto fresh main with the gates re-run. A mailbox question nobody answers parks its ticket once `queue.question-timeout` elapses. It stops when nothing is left to do; running it again resumes whatever parked.
How to run it
lightsout queue| flag | meaning | left out |
|---|---|---|
| --file-relay [dir] | Relay questions as files in a mailbox directory instead of asking on this terminal. Defaults to .lightsout/queue/relay under the repo, emptied at startup. | Questions are asked on the terminal that started the drain. |
| --cwd <path> | Repository to drain into. | The process working directory. |