Getting Started

Install jq 30 sec

Hooks need jq to read JSON. Check if you have it:

jq --versionCopy

If not installed:

# macOS
brew install jq

# Ubuntu / Debian
sudo apt install jq

# Windows (in WSL)
sudo apt install jqCopy

Run one command 30 sec

This installs 8 safety hooks and configures your settings.json:

npx cc-safe-setupCopy

You'll see a list of hooks. Press Y to install.

Restart Claude Code 10 sec

Hooks load on startup. Close Claude Code and reopen it:

# In your terminal, exit Claude Code (Ctrl+C or type /exit)
# Then start it again
claudeCopy

Verify hooks work 30 sec

Run the diagnostic to confirm everything is set up:

npx cc-safe-setup --doctorCopy

All items should show ✓. If any show ✗, the doctor tells you how to fix it.

Simulate a dangerous command 30 sec

See how hooks react without actually running the command:

npx cc-safe-setup --simulate "rm -rf /"Copy

You should see: ✗ BLOCK — destructive-guard

npx cc-safe-setup --simulate "git status"Copy

You should see: → This command would trigger a permission prompt

Auto-approve read-only commands 30 sec

Tired of approving ls, cat, and git log? This hook auto-approves commands that can't modify anything:

npx cc-safe-setup --install-example auto-approve-readonlyCopy

Reduces permission prompts by about 80%. Only commands that write, delete, or push still require approval.

Auto-approve test commands 10 sec

npx cc-safe-setup --install-example auto-approve-testCopy

npm test, pytest, go test, cargo test — all auto-approved.

Shield mode 30 sec

For autonomous sessions where Claude runs unattended:

npx cc-safe-setup --shieldCopy

Installs everything from steps 1-6 plus: scope guard, memory write guard, skill gate, and project-specific hooks based on your tech stack.