nightshift — Claude Code hook: what it does, how to install
nightshift binds Codex work sessions to strict time limits, tracking punch lists, deferred decisions, and run logs.
MIT ★ 1,596 updated 2026-10-29
.claude/settings.jsonWhat nightshift does
The nightshift bundle ties into the agent execution cycle across five triggers: PreToolUse, PostToolUse, UserPromptSubmit, SessionEnd, and Stop. Each event executes dedicated logic. For instance, the hardhat guard runs before tools execute, while clock-out-gate checks status on stop.
Implementations exist for both POSIX platforms and Windows. On Linux or macOS, Claude Code runs shell scripts under hooks/codex/. Windows environments rely on encoded PowerShell commands executed with -ExecutionPolicy Bypass. If PowerShell script execution is restricted on Windows, the gate hooks will fail.
What it helps with
- enforce time bounds on Codex work sessions
- maintain a persistent punch list across runs
- review execution logs after sessions finish
- track parked decisions without derailing the shift
Example prompts for the agent
- Start a new Codex shift and list the pending punch list items.
- Park this architectural decision and trigger session wrap-up.
- Verify active shift status before invoking external tools.
How to install nightshift
Manually: put the files in place
.claude/settings.jsonThe hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json
Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command
Questions about nightshift
How to install nightshift in Claude Code?
Add the hook definitions to .claude/settings.json. Claude Code will automatically trigger the scripts during tool use and session transitions.
What does nightshift do?
It manages structured, accountable sessions for Codex. The bundle tracks active task lists, records run history, and intercepts agent stops.
Which lifecycle events does nightshift intercept?
The bundle hooks into PreToolUse, PostToolUse, UserPromptSubmit, SessionEnd, and Stop.
Source text
hooks.json · MIT
Hooks bundle shipped with the nightshift plugin for Claude Code.
Accountable, time-bounded Codex shifts with a persistent punch list, parked decisions, and reviewable run history.
Triggers on: PreToolUse, PostToolUse, UserPromptSubmit, SessionEnd, Stop.
```json
{
"description": "nightshift guards for Codex: the PreToolUse hardhat, the Stop clock-out gate, SessionEnd, the PostToolUse pulse, and the UserPromptSubmit plan-room exit.",
"hooks": {
"PreToolUse": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/codex/hardhat.sh\"",
"commandWindows": "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand JABFAHIAcgBvAHIAQQBjAHQAaQBvAG4AUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAdABvAHAAJwA7ACAAJABQAHIAbwBnAHIAZQBzAHMAUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAaQBsAGUAbgB0AGwAeQBDAG8AbgB0AGkAbgB1AGUAJwA7ACAAJABpAG4AcAB1AHQAIAB8ACAAJgAgACgASgBvAGkAbgAtAFAAYQB0AGgAIAAtAFAAYQB0AGgAIAAkAGUAbgB2ADoAUABMAFUARwBJAE4AXwBSAE8ATwBUACAALQBDAGgAaQBsAGQAUABhAHQAaAAgACcAaABvAG8AawBzAC8AdwBpAG4AZABvAHcAcwAvAGgAYQByAGQAaABhAHQALgBwAHMAMQAnACkAIAAtAEgAbwBzAHQATgBhAG0AZQAgAGMAbwBkAGUAeAA7ACAAZQB4AGkAdAAgACQATABBAFMAVABFAFgASQBUAEMATwBEAEUA"
}
]
}
],
"PostToolUse": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/codex/pulse.sh\"",
"commandWindows": "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand JABFAHIAcgBvAHIAQQBjAHQAaQBvAG4AUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAdABvAHAAJwA7ACAAJABQAHIAbwBnAHIAZQBzAHMAUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAaQBsAGUAbgB0AGwAeQBDAG8AbgB0AGkAbgB1AGUAJwA7ACAAJABpAG4AcAB1AHQAIAB8ACAAJgAgACgASgBvAGkAbgAtAFAAYQB0AGgAIAAtAFAAYQB0AGgAIAAkAGUAbgB2ADoAUABMAFUARwBJAE4AXwBSAE8ATwBUACAALQBDAGgAaQBsAGQAUABhAHQAaAAgACcAaABvAG8AawBzAC8AdwBpAG4AZABvAHcAcwAvAHAAdQBsAHMAZQAuAHAAcwAxACcAKQAgAC0ASABvAHMAdABOAGEAbQBlACAAYwBvAGQAZQB4ADsAIABlAHgAaQB0ACAAJABMAEEAUwBUAEUAWABJAFQAQwBPAEQARQA="
}
]
}
],
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/codex/session-end.sh\"",
"commandWindows": "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand JABFAHIAcgBvAHIAQQBjAHQAaQBvAG4AUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAdABvAHAAJwA7ACAAJABQAHIAbwBnAHIAZQBzAHMAUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAaQBsAGUAbgB0AGwAeQBDAG8AbgB0AGkAbgB1AGUAJwA7ACAAJABpAG4AcAB1AHQAIAB8ACAAJgAgACgASgBvAGkAbgAtAFAAYQB0AGgAIAAtAFAAYQB0AGgAIAAkAGUAbgB2ADoAUABMAFUARwBJAE4AXwBSAE8ATwBUACAALQBDAGgAaQBsAGQAUABhAHQAaAAgACcAaABvAG8AawBzAC8AdwBpAG4AZABvAHcAcwAvAHMAZQBzAHMAaQBvAG4ALQBlAG4AZAAuAHAAcwAxACcAKQAgAC0ASABvAHMAdABOAGEAbQBlACAAYwBvAGQAZQB4ADsAIABlAHgAaQB0ACAAJABMAEEAUwBUAEUAWABJAFQAQwBPAEQARQA="
}
]
}
],
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/codex/prompt-submit.sh\"",
"commandWindows": "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand JABFAHIAcgBvAHIAQQBjAHQAaQBvAG4AUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAdABvAHAAJwA7ACAAJABQAHIAbwBnAHIAZQBzAHMAUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAaQBsAGUAbgB0AGwAeQBDAG8AbgB0AGkAbgB1AGUAJwA7ACAAJABpAG4AcAB1AHQAIAB8ACAAJgAgACgASgBvAGkAbgAtAFAAYQB0AGgAIAAtAFAAYQB0AGgAIAAkAGUAbgB2ADoAUABMAFUARwBJAE4AXwBSAE8ATwBUACAALQBDAGgAaQBsAGQAUABhAHQAaAAgACcAaABvAG8AawBzAC8AdwBpAG4AZABvAHcAcwAvAHAAcgBvAG0AcAB0AC0AcwB1AGIAbQBpAHQALgBwAHMAMQAnACkAIAAtAEgAbwBzAHQATgBhAG0AZQAgAGMAbwBkAGUAeAA7ACAAZQB4AGkAdAAgACQATABBAFMAVABFAFgASQBUAEMATwBEAEUA"
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT}/hooks/codex/clock-out-gate.sh\"",
"commandWindows": "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand JABFAHIAcgBvAHIAQQBjAHQAaQBvAG4AUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAdABvAHAAJwA7ACAAJABQAHIAbwBnAHIAZQBzAHMAUAByAGUAZgBlAHIAZQBuAGMAZQAgAD0AIAAnAFMAaQBsAGUAbgB0AGwAeQBDAG8AbgB0AGkAbgB1AGUAJwA7ACAAJABpAG4AcAB1AHQAIAB8ACAAJgAgACgASgBvAGkAbgAtAFAAYQB0AGgAIAAtAFAAYQB0AGgAIAAkAGUAbgB2ADoAUABMAFUARwBJAE4AXwBSAE8ATwBUACAALQBDAGgAaQBsAGQAUABhAHQAaAAgACcAaABvAG8AawBzAC8AdwBpAG4AZABvAHcAcwAvAGMAbABvAGMAawAtAG8AdQB0AC0AZwBhAHQAZQAuAHAAcwAxACcAKQAgAC0ASABvAHMAdABOAGEAbQBlACAAYwBvAGQAZQB4ADsAIABlAHgAaQB0ACAAJABMAEEAUwBUAEUAWABJAFQAQwBPAEQARQA="
}
]
}
]
}
}
```
© Orwa Mahmoud · MIT · hashgraph-online/awesome-codex-plugins