Project
Nightshift FAQ
Direct answers about autonomous shifts, safety, recovery, installs, platforms, commits, pushing, and the clock-out gate.
Answers: Nightshift frequently asked questions · Updated
Nightshift is a local-first, MIT-licensed plugin that gives Codex and Claude Code a durable engineering contract, optional mechanical rules, recovery, and reviewable receipts. It does not replace project tests, human review, or host permissions.
Core questions
These are the short answers people usually need before trying a first shift.
- Nightshift works from a punch list or an evidence-ranked catalog shift.
- The state stays in the project’s private .nightshift workspace.
- Commits are local by default and pushes are explicit.
- The owner can stop the shift at any time.
- The first run should be attended.
Trust boundary
The clock-out gate enforces that approved boxes are not quietly abandoned. It does not independently prove that a checked item is correct. Good definitions of done, project gates, and human review remain essential.
Start with a bounded prompt
This prompt names the outcome and preserves Nightshift’s review boundary. Paste it into the supported coding host from the project you want to change.
Answer my questions about Nightshift using only the released product behavior and link me to the relevant evidence.What this workflow does not claim
- Nightshift does not replace project tests, host permissions, or human review.
- Support is claimed only for the verified hosts and environment boundaries documented in the repository.
Evidence and sources
These links support the released behavior, public outcomes, or problem language described on this page.
Frequently asked questions
What is Nightshift?
Nightshift is an open-source plugin for accountable, time-bounded engineering shifts in Codex and Claude Code.
Does Nightshift keep working after context compaction?
Yes. The authoritative punch list, decisions, and progress live on disk, so the contract survives compaction and controlled recovery.
Can Nightshift run without a prepared backlog?
Yes. Hunt can inspect the repository, rank applicable catalog work, and either wait for review or run directly when explicitly authorized.
Does Nightshift push code?
Not by default. It creates local commits for review; pushing requires explicit authorization in the shift contract.
Can I stop a shift?
Yes. Use the host Stop command or create the .nightshift/STOP file. Unfinished items remain open.
Claude Code died overnight with API Error 500 or 529 Overloaded — does the run resume automatically?
Yes. The night watchman detects the dead session, waits out the outage on its interval, and revives the same recorded conversation with the punch list intact.
What stops an overnight shift from eating my whole API allowance?
Your plan's limits are the hard ceiling — Nightshift runs inside an ordinary session. Open-ended shifts take an explicit hour budget, checklist shifts end when the last box is ticked, and the contract is written before the run.
Does the clock-out gate prove the implementation?
No. It enforces the declared completion contract. Project checks and human review establish whether the implementation is correct.
Which platforms are supported?
macOS and Linux use the bundled shell runtime. Native Windows uses bundled PowerShell. WSL is supported as a Linux environment when all components stay in one distribution.
Is Nightshift a hosted service?
No. It is a plugin with local project state; no separate server or Nightshift API key is required.