Nightshift plugin
The Nightshift plugin gives an agent a shift with a work contract: task list, budgets, evidence and a gate until the job is done.
- 390 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The plugin installs hooks that block session completion and write progress files.
- The agent works for hours unattended and its changes must be reviewed.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/nightshiftDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The plugin installs hooks that block session completion and write progress files.
- The agent works for hours unattended and its changes must be reviewed.
This is third-party code. Review the repository files before installing.
What it does
Nightshift is a plugin for Claude Code, Codex and Cursor that makes long runs reviewable. First you plan the work with the agent in a plan room: code exploration, a pre-mortem and an edge-case pass. Then you set a task list, a ready-made shift or an objective with hours. A clock-out gate stops the agent from leaving with an unfinished list. Each item can carry evidence and a time or token budget. Progress survives context compaction and lives on disk, and a watchman recovers failed sessions. In the morning there are receipts with token usage and time per item, and the shift is archived with its evidence.
Who it is for. Developers who leave an agent working for hours and want a reviewable result in the morning instead of a "done" report on half the list.
Good fit when
- Nine edits are planned for the evening and the agent must close all of them, not just the easy ones.
- Each item must pass a test command before the shift ends.
- A session crashed in the middle of the night and work should resume without losing the list.
- In the morning you need to see tokens and time spent on each item.
Not a fit when
- The task takes five minutes and needs no list.
- You want a reviewer that replaces your own look: checks and your review still decide if work is good.
- You work without hooks and will not trust them with configuration.
Example request
Plan a four-hour shift from a list of nine edits, set a check and a token budget for each.Limitations
The plugin uses hooks, which must be reviewed and trusted with `/hooks` in the CLI before the first run. The OpenAI Plugin Directory edition is reduced: it targets attended sessions and omits the clock-out gate, recovery and usage accounting. Token and time accounting is not complete everywhere, with host-specific gaps marked. A completed item does not mean good work, so checks and your review stay mandatory. The last commit is from November 2026.
How to disable. Remove the plugin with `/plugin` in Claude Code or through the Codex or Cursor plugin manager. Delete shift archives and receipts in the project separately.
FAQ
How is the clock-out gate different from a plain hook?
It rejects premature clock-out while items lack the required evidence. Strictness is configurable.
How do I install in Codex?
With `codex plugin marketplace add orwa-mahmoud/nightshift` and `codex plugin add nightshift@nightshift`. Then trust the hooks.
Is a separate service or API key needed?
No. The plugin needs no separate service or key and is MIT licensed.
What is a receipt?
A record of an item: evidence, measured tokens and time. A morning receipt summarizes the shift.
What if the shift did not finish?
Unfinished items stay in the archive and remain available for the next shift.
Discussion
No questions or reviews yet.
Related
PluginsA plugin for long Claude Code runs: context, cache and progress at a glance, with handoff to a fresh context before it fills.
A collection of 14 portable skills for long agent runs: work planning, live app QA, search across past sessions and a phone call
One local memory for Codex, Claude Code, Cursor, Hermes Agent and OpenClaw: agents hand off tasks, review each other and refine their skills overnight
A Codex skill for an autonomous loop: Claude Code computes, Codex reviews hourly, critiques and sends the next prompt.
Agents that keep working without you: brief one once, and Overtime wakes it on a schedule and asks only what is yours to decide
The ctx-handoff plugin for Claude Code: hands a long session to a fresh one, keeps cache warm and learns your corrections.
README in short
The README has a feature table, descriptions of real four-hour and 45-hour runs, the origin story and install steps for Claude Code, Codex and Cursor. MIT license.