purge

SkillDev tools

Permanently delete this project's Nightshift state; does not uninstall the plugin.

Use purge in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add purge and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the purge skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

What this skill tells your AI

The instructions your AI receives, as published by hashgraph-online/awesome-codex-plugins in plugins/orwa-mahmoud/nightshift/skills/purge/SKILL.md and read by Ahel’s review.

Remove Nightshift from this project. This deletes punch lists, rules, receipts, archives, and history under the project's .nightshift/ directory. It does not uninstall the global Nightshift plugin.

Resolve the installed plugin root to an absolute $NIGHTSHIFT_PLUGIN_ROOT — ${CLAUDE_PLUGIN_ROOT} on Claude Code, $PLUGIN_ROOT on Codex when set, otherwise the absolute path this skill was attached from (skills/purge/SKILL.md). Run every command below through "$NIGHTSHIFT_PLUGIN_ROOT/runtime/ns" — native Windows: & "$NIGHTSHIFT_PLUGIN_ROOT\runtime\windows\ns.ps1" in the PowerShell tool, same verbs — which resolves the host and the workspace; ns help lists the verbs, and ns bind prints the six resolved facts (TASK_ROOT, NIGHTSHIFT_WORKSPACE, NS, NIGHTSHIFT_PLUGIN_ROOT, HOST, SOURCE); $NS below is that NS. Never a bare relative path: the working directory persists between calls. Each $NS/... path below is where the current layout keeps that file; ns path <key> prints where this workspace keeps it, and ns path --list names every key.

Print the exact canonical $NS path. Warn that punch lists, rules, receipts, archives, and history will be lost, and that the plugin itself stays installed. Do not run the helper until the owner confirms that exact path. Then:

"$NIGHTSHIFT_PLUGIN_ROOT/runtime/ns" purge-workspace \
  --confirm-path "$NS"

The helper first performs Reset, then deletes only that validated .nightshift/ directory and a local .nightshift-link on the opened task root when present. It refuses symlinks, malformed links, workspace roots, home directories, /, and other broad paths. It never deletes repository files outside that Nightshift state. A second Purge with the same confirmation is safe.

If the task root is linked, pass the folder you opened as --project "$TASK_ROOT". This is the one command whose target is the task root rather than the workspace, so it is the one place the dispatcher's answer is not the one you want: purging only the workspace path leaves the host link in place.

Signals

GitHub stars
1k
Forks
316
Last commit
Oct 2026
Advanced
Item type
skill
Key
purge
Source
github.com/hashgraph-online/awesome-codex-plugins