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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/orwa-mahmoudnightshift.svg)](https://yunodb.com/tools/orwa-mahmoudnightshift?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/orwa-mahmoudnightshift?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/orwa-mahmoudnightshift.svg" alt="Featured on YunoDB" height="20"></a>