stop

Pauses an active Nightshift coding shift while preserving unfinished work items on disk.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running autonomous coding shifts sometimes need to be interrupted so the owner can edit the punch list or regain control, but killing the agent process risks losing state or corrupting the session. This Skill issues a safe stop-work order that pauses the shift while keeping all progress, deadlines, and receipts intact on disk. ## Core Features & Use Cases - Safe teardown via trusted helper: Runs the ns stop-shift helper which writes a timestamped STOP marker, appends to the shift log, and terminates only a verified live watchman process. - State preservation: Keeps the deadline, punch list, receipts, archives, and shift history on disk so work can resume later with the Start command. - Panic fallback: Supports a manual touch $NS/STOP escape hatch from any terminal when the model is unresponsive. - Use Case: You launched an overnight coding shift but realize the punch list needs changes. Invoke the stop skill to pause immediately, edit the list, then resume with Start without losing any recorded progress. ## Quick Start Ask the agent to stop the current Nightshift shift now and report how many items remain open.

Frequently Asked Questions about stop

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

FAQPage Schema
How do I stop a running Nightshift coding shift?

Invoke the stop skill, which runs the ns stop-shift helper from the plugin runtime. The helper writes a STOP marker with a UTC timestamp, logs the stop event, and safely terminates the watchman process without deleting shift state.

How do I resume a Nightshift shift after stopping it?

Resume with the Start command (/nightshift:start on Claude Code, or ask Nightshift to start on Codex). Start clears the pause markers and begins a new ownership lease, keeping a future preserved deadline as the deadline.

Does stopping a shift delete my progress or deadline?

No. Stopping preserves the deadline, punch list, receipts, archives, and shift history on disk. Open items stay open as the record, and only the session marker is dropped so the same conversation is not reused.

What if the agent is stuck and will not run the stop command?

Use the panic form: run touch "$NS/STOP" from any POSIX terminal, or New-Item -ItemType File -Force "$NS\STOP" in Windows PowerShell. The marker is honored at the next Stop event or watchman wake.

Does the stop skill work on Windows?

Yes. On native Windows, commands run through the ns.ps1 PowerShell script in the plugin's runtime/windows directory with the same verbs. The skill resolves the correct host and workspace automatically via ns bind.