How lennney/stop-that-shit works
Stop That Shit is a task-boundary Guard for AI coding agents. A user gives the host a mode and contract—such as read-only review or an allowed file/dependency scope—then the host adapter translates prompts and tool lifecycle events into control events. The controller checks actions against the contract and delegation state, returns an allow, stop, or observe response, and records runtime outcomes. Host adapters and classifiers cover Claude Code, Codex, Hermes, OpenCode, Pi, and Oh My Pi. The README documents these capabilities; source excerpts are partial, so links for unsampled adapters rely on the SOURCE INDEX.
Main entry points: controller.cjs Event controller · codex-tool-classifier.cjs Tool classifiers · claude-hooks.cjs Claude hooks · codex-hooks.cjs Codex hooks
Components 20
Host integrations
- Claude hooks
src/adapters/claude-hooks.cjs - Codex hooks
src/adapters/codex-hooks.cjs - Hermes hooks
src/adapters/hermes-hooks.cjs - OpenCode plugin
opencode/stop-that-shit.mjs - OpenCode hooks
src/adapters/opencode-hooks.cjs - Pi hooks
src/adapters/pi-hooks.cjs - Oh My Pi hooks
src/adapters/omp-hooks.cjs - Tool classifiers
src/adapters/codex-tool-classifier.cjs
Policy and decisions
- Task contracts
src/contracts.cjs - Policy decision
src/decision.cjs - Delegation ledger
src/delegation-state.cjs - Dependency intent
src/manifest-dependencies.cjs
State and runtime records
- Session state
src/state.cjs - Runtime audit
src/runtime-audit.cjs - Runtime annotations
src/runtime-annotations.cjs - JSONL storage
src/runtime-storage.cjs
Guard runtime
- Control protocol
src/control-protocol.cjs - Event controller
src/controller.cjs
Other components
- Agent user
- Agent hosts
Connections 33
- Agent user → Agent hosts: sets task
README.md - Agent hosts → Claude hooks: emits events
README.md - Agent hosts → Codex hooks: emits events
README.md - Agent hosts → Hermes hooks: emits events
README.md - Agent hosts → OpenCode plugin: emits events
README.md - Agent hosts → Pi hooks: emits events
README.md - Agent hosts → Oh My Pi hooks: emits events
README.md - OpenCode plugin → OpenCode hooks: routes events
opencode/stop-that-shit.mjs - Claude hooks → Tool classifiers: classifies tools
src/adapters/claude-hooks.cjs - Codex hooks → Tool classifiers: classifies tools
src/adapters/codex-hooks.cjs - Hermes hooks → Tool classifiers: classifies tools
src/adapters/hermes-hooks.cjs - OpenCode hooks → Tool classifiers: classifies tools
src/adapters/opencode-hooks.cjs - Pi hooks → Tool classifiers: classifies tools
src/adapters/pi-hooks.cjs - Oh My Pi hooks → Tool classifiers: classifies tools
src/adapters/omp-hooks.cjs - Tool classifiers → Dependency intent: checks manifests
src/adapters/codex-tool-classifier.cjs - Claude hooks → Event controller: submits events
src/adapters/claude-hooks.cjs - Codex hooks → Event controller: submits events
src/adapters/codex-hooks.cjs - Hermes hooks → Event controller: submits events
src/adapters/hermes-hooks.cjs - OpenCode hooks → Event controller: submits events
src/adapters/opencode-hooks.cjs - Pi hooks → Event controller: submits events
src/adapters/pi-hooks.cjs - Oh My Pi hooks → Event controller: submits events
src/adapters/omp-hooks.cjs - Event controller → Control protocol: validates events
src/controller.cjs - Event controller → Task contracts: parses directives
src/controller.cjs - Event controller → Policy decision: decides actions
src/controller.cjs - Event controller → Delegation ledger: tracks agents
src/controller.cjs - Policy decision → Delegation ledger: inspects budget
src/decision.cjs - Event controller → Session state: reads and writes
src/controller.cjs - Event controller → Runtime audit: records decisions
src/controller.cjs - Event controller → Runtime annotations: records annotations
src/controller.cjs - Runtime audit → JSONL storage: persists events
src/runtime-audit.cjs - Runtime annotations → JSONL storage: persists labels
src/runtime-annotations.cjs - Session state → Task contracts: uses defaults
src/state.cjs - Event controller → Agent hosts: returns response