Documentation

Install Nightshift

Install Nightshift for Cursor, Codex, or Claude Code and open the persistent project or folder you want it to work in.

Updated 23 September 2026

SHORT ANSWER

How do I install Nightshift in Claude Code, Codex, or Cursor?

Choose the native installation path for your coding host, then invoke Setup from a persistent project or notes folder. The same local-first package needs no separate Nightshift server or API key.

Codex and repository-connected ChatGPT

The simplest path is the official OpenAI Plugin Directory. For local Codex development, install the same package from its Git-hosted marketplace.

codex plugin marketplace add orwa-mahmoud/nightshift
codex plugin add nightshift@nightshift

Install from the official OpenAI Plugin Directory ↗

Claude Code

Run these two commands inside Claude Code. Nightshift needs no npm package, separate CLI, API key, or server.

/plugin marketplace add orwa-mahmoud/nightshift
/plugin install nightshift

Cursor

Inside Cursor, open Customize → Add → From GitHub Repository, import https://github.com/orwa-mahmoud/nightshift, then select Nightshift from the imported marketplace to install it. Open the persistent project before Setup. The Cursor Directory listing is for discovery; installation happens inside Cursor.

Released Cursor install instructions ↗Cursor Directory listing ↗

Choose the project

Open the repository or project that should receive the work before setup. A disposable scratch conversation is temporary and cannot preserve changes to that project.

macOS and Linux use the bundled shell runtime.
Native Windows uses the bundled PowerShell runtime.
WSL is treated as Linux and should keep host, repository, plugin, and watchman in one distribution.
The plugin ships shell and PowerShell only: no Python, and no JSON parser to install.

TRY IT

Start with a bounded prompt

This prompt names the outcome and preserves Nightshift’s review boundary. Paste it into the supported coding host from the project you want to change.

Set up Nightshift in this project and explain each proposed gate before writing it.

Read the repository

BOUNDARIES

What this workflow does not claim

A normal ChatGPT scratch conversation cannot preserve changes to the project repository.
An unattended shift needs host permissions appropriate to its repository or artifact work mode.

SOURCES

Evidence and sources

These links support the released behavior, public outcomes, or problem language described on this page.

Cursor Directory listingThe public community listing for Nightshift's shipped Cursor plugin.Open evidence ↗Official OpenAI listingThe published Nightshift entry in OpenAI's Plugin Directory.Open evidence ↗Installation guideThe repository's released host installation and first-run guidance.Open evidence ↗Setup skillThe shipped setup, workspace, rules, and first-run guidance.Open evidence ↗