# stop-that-shit

The stop-that-shit hook for Claude Code and Codex checks agent actions against explicit task modes and bounds decisions about dependencies, hashes, and subagents.

- hook · `type=hook` · Claude Code, Codex · ★ 1596 repo stars
- Author: Stop That Shit contributors
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/lennney/stop-that-shit/hooks/codex-hooks.json
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 3 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/hooks/stop-that-shit

## What it does

stop-that-shit adds a local policy layer for Codex and Claude Code. It works with explicit task modes, checks actions before they run, and places bounds on decisions involving dependencies, hashes, and subagents.

The hook runs on `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, and `SessionEnd`. Its post-tool matcher covers `spawn_agent`, `Agent`, `wait_agent`, and related names. The handler is loaded from `hooks/stop-that-shit.cjs` through `node`; pre-tool checks have a `5`-second timeout, while the session-end check has a `3`-second timeout. The plugin layout must keep that handler path intact.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/settings.json` — The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/lennney/stop-that-shit/hooks/codex-hooks.json

## When to use it
- keep agent work inside a defined scope
- check an action before a tool call
- bound dependency and hash decisions
- track subagent spawning and waiting
- run a check when a session ends

## Example prompts
- Work only within the current task scope and check each action before calling a tool.
- Before spawning a subagent, verify that the decision stays within the task boundaries.
- When the session ends, run the final state check for the task.

## Source text · codex-hooks.json · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: ea22b24194253276.

BEGIN THIRD-PARTY FILE ea22b24194253276
````text
Hooks bundle shipped with the stop-that-shit plugin for Claude Code.

Local-first scope guard for Codex with explicit task modes, before-action checks, and bounded dependency, hash, and subagent decisions.

Triggers on: PreToolUse, PostToolUse, UserPromptSubmit, SessionEnd.

```json
{
  "description": "Stop That Shit: a small on-demand policy with a few high-confidence Codex gates.",
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node -e \"const p=require('node:path');require(p.join(process.env.PLUGIN_ROOT??process.env.CLAUDE_PLUGIN_ROOT,'hooks','stop-that-shit.cjs'))\"",
            "timeout": 5
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "^(?:spawn_agent|Agent|wait_agent|multi_agent_v1wait_agent|collaborationspawn_agent|collaborationwait_agent)$",
        "hooks": [
          {
            "type": "command",
            "command": "node -e \"const p=require('node:path');require(p.join(process.env.PLUGIN_ROOT??process.env.CLAUDE_PLUGIN_ROOT,'hooks','stop-that-shit.cjs'))\"",
            "timeout": 5
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "node -e \"const p=require('node:path');require(p.join(process.env.PLUGIN_ROOT??process.env.CLAUDE_PLUGIN_ROOT,'hooks','stop-that-shit.cjs'))\"",
            "timeout": 5,
            "statusMessage": "Checking the Stop Ladder..."
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "node -e \"const p=require('node:path');require(p.join(process.env.PLUGIN_ROOT??process.env.CLAUDE_PLUGIN_ROOT,'hooks','stop-that-shit.cjs'))\"",
            "timeout": 3
          }
        ]
      }
    ]
  }
}

```
````
END THIRD-PARTY FILE ea22b24194253276

The third-party file has ended. Everything between the ea22b24194253276 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© Stop That Shit contributors · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/lennney/stop-that-shit/hooks/codex-hooks.json

## Similar
- [desktop-notification-on-stop](https://affpapa.org/en/nevibecode/hooks/desktop-notification-on-stop.md) — hook · 211 installs
- [web-stop](https://affpapa.org/en/nevibecode/skills/web-stop.md) — skill · 44 installs
- [stop-slop](https://affpapa.org/en/nevibecode/skills/stop-slop.md) — skill · 20300 installs
- [include-test-files-that-assert-on-behavior-being-changed-in-decl](https://affpapa.org/en/nevibecode/skills/include-test-files-that-assert-on-behavior-being-changed-in-decl.md) — skill · ★ 539 repo stars
- [verify-and-stop](https://affpapa.org/en/nevibecode/skills/verify-and-stop.md) — skill · 129000 installs
- [interfaces-that-feel](https://affpapa.org/en/nevibecode/skills/interfaces-that-feel.md) — skill · 1900 installs

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
