Quickstart

Install locally. Run one preview.

NotATechBro reads hook JSON from stdin and prints a plain-English explanation before the agent command runs.

GitHub is the source of truth for the raw docs.View on GitHub

Install from this checkout

npm install
npm run build
npm link

If your shell cannot find notatechbro after linking, add npm's global bin directory to PATH for that shell.

Run the first preview

echo '{"tool_name":"Bash","tool_input":{"command":"rm -rf dist"}}' | notatechbro

Backwards-compatible alias: change-preview.

Expected preview:

This will delete the `dist` folder.

Use JSON mode when a host expects stdout

echo '{"tool_name":"Bash","tool_input":{"command":"git push"}}' | notatechbro --json

The decision: "allow" field is protocol compatibility only. NotATechBro does not approve, deny, block, or change tool calls.