setup

Scaffolds the .nightshift workspace and configures quality gates for unattended agent shifts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a project for long unattended AI coding runs requires consistent state files, quality gates, permissions, and rules; doing this by hand is error-prone and easy to get wrong. This Skill scaffolds the entire .nightshift/ workspace and walks the owner through every configuration choice without imposing defaults. ## Core Features & Use Cases - Workspace scaffolding: Creates the .nightshift/ state files idempotently, detects repository vs artifact work mode, and never clobbers an existing shift. - Quality gate configuration: Detects the project stack, proposes verification gates, and lets the owner accept, edit, or decline them. - Permissions and rules setup: Configures frictionless permissions for unattended runs, copies the rules.json template, and optionally creates a local receipts repo or Cursor CLI hooks. - Use Case: A developer wants Claude Code or Codex to work through a punch list overnight; they run setup once to scaffold state, approve gates, and enable permissions so the shift never stalls on a prompt. ## Quick Start Ask the agent to set up Nightshift in this project and follow its prompts to confirm the work mode, gates, and permissions.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I set up Nightshift in my project?

Ask the agent to set up Nightshift in the project. The skill scaffolds the .nightshift/ state files, detects whether the workspace is a Git repository or a plain artifact folder, and asks before persisting the work mode, gates, and permissions.

How do I configure quality gates for an unattended coding shift?

The setup skill detects the project stack from a gates catalog and proposes verification commands. You can accept the proposal, edit it with your own shell commands, or choose none, and the result is written into the Gates block of the punch list.

Does Nightshift setup work on Windows and non-git folders?

Yes. Native Windows uses a bundled PowerShell scaffold, and folders without Git run in artifact mode where completion is recorded as receipts under .nightshift/receipts/ instead of commits. Disposable ChatGPT scratch workspaces are rejected.

Why does an unattended agent shift stall on permission prompts?

An unattended run cannot answer permission prompts, so it freezes until morning. Setup offers to enable bypassPermissions on Claude Code or explains the Codex sandbox trade, and suggests pre-allowing only the punch list's tools as a narrower alternative.

Will setup overwrite my existing Nightshift configuration?

No. The scaffold copies only absent files and reports kept versus written names, so re-running is a safe repair. Existing rules.json values are never touched; new template keys are only offered individually with an explicit yes.