start

Start a nightshift. Work in `$CLAUDE_PROJECT_DIR`. ## 1. Preflight - **One shift, one agent — check before touching anything.** Read `.nightshift/.shift-session`. If it records a session that is still alive — line 3's pid exists and `ps -o lstart= -p <pid>` matches line 4, or the id on line 1 appears in `claude agents --json` — an agent is ALREADY working this punch list. Do not start a second one beside it. Tell the owner and hand them the running thread: `claude --resume <id>` for a terminal, `vscode://anthropic.claude-code/open?session=<id>` for the IDE — and stop here; `touch .nightshift/STOP` is the lever if they want that shift ended first. A record whose process is dead is last night's leftover: fall through and clear it below. - **Clear every stale run-control marker first**, before anything writes a new one — last night's leftovers would otherwise end tonight's shift at its first stop attempt. Remove them all if present: `.nightshift/STOP`, `.nightshift/.stall`, `.nightshift/.notified`, `.nightshift/.ended`, `.nightshift/deadline`, `.nightshift/.session-end`, `.nightshift/.shift-session`, `.nightshift/.watchman-tick`, and the `.nightshift/.lock.d/` directory. If `.nightshift/.watchman` holds a live pid, kill it — last night's watchman must not double-arm tonight's. A shift that reached the whistle leaves the deadline behind; keeping it means the gate clocks the next one out immediately, zero items done. - If `.nightshift/work-orders.md` ...