nightshift

Executes autonomous multi-hour coding shifts against a persistent punch list with gated clock-out and receipts.

63|3|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/orwa-mahmoud/nightshift --skill nightshift-orwa-mahmoud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nightshift
Source: https://github.com/orwa-mahmoud/nightshift/tree/main/plugins/nightshift/skills/nightshift
Command: npx skills add https://github.com/orwa-mahmoud/nightshift --skill nightshift-orwa-mahmoud

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Long-running AI coding sessions tend to stop early, leave hard items unfinished, and lose progress when a session crashes or compacts. Nightshift gives Claude Code, OpenAI Codex, and Cursor a durable work contract: a punch list the agent cannot walk away from, a clock-out gate that blocks premature stops, and on-disk records that survive interruptions. ## Core Features & Use Cases - Punch-list enforcement: Work items live in .nightshift/punch-list.md with per-item Verify and Commit lines; the clock-out gate holds the session until every box is ticked or a stop-work order lands. - Receipts and morning handoff: Each item gets a narrative receipt under .nightshift/receipts/, plus a morning page summarizing commits, parked decisions, and remaining work. - Park-don't-ask autonomy: Owner decisions get a sensible production default recorded in parking-lot.md instead of blocking the run, so unattended overnight shifts keep moving. - Recovery and walkthroughs: A watchman can revive crashed sessions, and open-ended walkthroughs (coverage hunts, defect hunts, product evolution) run against a deadline with snag-log deduplication. - Use Case: Queue eight refactoring tasks on Friday evening, let the agent work them overnight with per-item gates and one conventional commit each, then review the receipts and parked decisions over coffee on Saturday. ## Quick Start Ask the agent to start a nightshift shift that works through the open items in the punch list until every box is ticked.

Frequently Asked Questions about nightshift

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an autonomous overnight coding session with Claude Code or Codex?

Arm a nightshift shift with a punch list of tasks in .nightshift/punch-list.md, then let the agent work items top to bottom. A clock-out gate blocks stopping until every box is ticked, and receipts plus a morning page record what was delivered.

What is a punch list in an autonomous agent workflow?

A punch list is a markdown contract of checkbox tasks, each with its own Verify and Commit lines, stored at .nightshift/punch-list.md. The agent works one item at a time, runs the gate before each commit, and cannot delete items or edit the contract to end the shift early.

Does nightshift work with Cursor and OpenAI Codex?

Yes, nightshift supports Claude Code, OpenAI Codex, and Cursor through host-specific watchman and permission setups. Codex shifts that commit need danger-full-access because workspace-write protects .git, while Cursor arms its own watchman with a recorded conversation id.

What happens if the agent crashes during a long autonomous run?

A watchman process detects crashed sessions and revives them using the recorded session id, falling back to a fresh session that resumes from the punch list. Progress survives on disk through receipts, the shift log, and per-item commits.

How does the agent handle decisions while the owner is asleep?

Question tools are denied during a shift, so the agent chooses a sensible production-grade default and records the decision with reasoning in parking-lot.md. The owner reviews parked decisions in the morning rather than being woken by questions.

When should I not use an unattended autonomous coding shift?

Avoid it for actions outside the coding boundary such as publishing, merging, deploying, deleting production data, or spending money, which still require the owner. It also requires a persistent project workspace, not a disposable scratch environment.