nightshift
Accountable long-running coding shifts for Cursor, Codex, and Claude Code. Safe autonomy, recovery, persistent state, and reviewable results: a clear view of wh
What is nightshift?
Accountable long-running coding shifts for Cursor, Codex, and Claude Code. Safe autonomy, recovery, persistent state, and reviewable results: a clear view of what’s done, in progress, parked, or blocked—without scrolling a marathon chat.
Overview of nightshift
What it is
Nightshift is an open-source tool that provides accountable, long-running coding shifts for AI coding agents such as Cursor, Codex, and Claude Code. It gives an agent a durable work contract with a task list, a deadline, and a clock-out gate that holds unfinished work. Progress is saved to disk, and a watchman can recover failed sessions. The tool is designed to produce reviewable results with a clear view of what is done, in progress, parked, or blocked. It is MIT licensed and works on macOS, Linux, and Windows without a separate service or API key. The project is hosted at https://github.com/orwa-mahmoud/nightshift, with a website at https://nightshift.orwamahmoud.com.
Key features
- Persistent punch list with item-by-item verification and a gate that rejects premature clock-out.
- Open-ended product evolution, coverage hunts, or custom objectives with an explicit deadline and a continuation record.
- Ready-made shifts through Hunt and Quality, allowing the agent to compose work or the user to review first.
- Progress across compaction, parked decisions, deduplicated findings, and recovery under the host's supported signals.
- Runtime-measured token usage and duration per item, with host-specific gaps clearly marked.
- Live receipts, a morning receipt, and archived history that keeps unfinished work available for the next shift.
Use cases
- Finishing work that was already planned, with a persistent punch list and verification.
- Putting a few hours into a project with an explicit deadline and a continuation record.
- Starting without writing a backlog by using ready-made shifts.
- Keeping a long run moving across compaction and recovery.
- Reviewing what the work consumed in terms of token usage and duration.
- Reviewing work today and continuing tomorrow with archived history.
Getting started
To install Nightshift for Codex and ChatGPT, run: text codex plugin marketplace add orwa-mahmoud/nightshift codex plugin add nightshift@nightshift For Claude Code, run inside Claude Code: text /plugin marketplace add orwa-mahmoud/nightshift /plugin install nightshift For Cursor, open Customize → Add → From GitHub Repository, paste https://github.com/orwa-mahmoud/nightshift, choose a scope, and select Import. Then select Nightshift from the imported marketplace to install it. For skills.sh, run: text npx skills add https://github.com/orwa-mahmoud/nightshift --skill install-nightshift For a first shift, start with one small task in a project you trust. Use commands like “Set up Nightshift in this project.” or “Improve this project for 5 hours.” See the repository README for full details.
License and pricing
The license is MIT. The pricing type is open source.
Based on the project's public README and repository metadata.