cc-safe-setup
Make Claude Code safe for autonomous operation
336
hooks
49
commands
974
tests
22
web tools
npx cc-safe-setup --shield
One command. 30 seconds. Zero dependencies.
Get Started
1
Run
npx cc-safe-setup --shield
โ installs hooks, detects your stack, generates CLAUDE.md
2
Run
npx cc-safe-setup --verify
โ confirms all hooks block correctly
3
For teams:
npx cc-safe-setup --team
โ commit
.claude/
to share with everyone
Tools & Documentation
๐
Getting Started
Safe in 5 minutes. Step-by-step for beginners. No coding required.
start here
๐
Safety Audit
Score your Claude Code setup out of 100. Find gaps and get fix suggestions.
interactive
โ๏ธ
Pre-Flight Checklist
14-point checklist before autonomous operation. Interactive, printable, shareable.
new
๐ณ
Recipes
Real problems โ copy-paste solutions. Permission fatigue, silent edits, syntax errors โ each with a working hook.
new
๐
Validator
Paste your settings.json โ get instant score, error detection, and improvement suggestions.
new
๐ฎ
Playground
Write hooks, test with sample inputs, see results instantly. Browser-based hook IDE.
new
๐
Cheat Sheet
30+ copy-paste hook patterns. Block, approve, monitor โ with one-click copy.
reference
๐ง
Hook Builder
Describe what you want in English. Get a working hook + settings.json entry.
generator
โก
By Example
10 real GitHub Issues. See the before (disaster) and after (hook saves it).
learn
๐
Hook Matrix
All hooks in a sortable, filterable table. Find exactly what you need.
interactive
โ
FAQ
15 questions answered. How hooks work, performance, debugging, and more.
reference
โ๏ธ
Settings Reference
Every settings.json field explained. Hooks, permissions, env, models.
reference
๐ฆ
Exit Codes
Exit 0 = allow. Exit 2 = block. Plus the bash syntax error trap that can lock your session.
critical
๐ง
Troubleshooting
10 common problems with step-by-step fixes. Hook not firing? Start here.
debug
๐ค
Which Hook?
Answer 2-3 questions โ get the exact hook you need. No knowledge required.
interactive
๐งฑ
10 Patterns
Block, Approve, Warn, Log, Validate, Protect, Limit, Checkpoint, Enforce, Recover.
reference
โ ๏ธ
Common Mistakes
7 mistakes that cause real incidents. Syntax error lockout, broad matchers, missing jq.
debug
โ๏ธ
Compare
Manual setup vs cc-safe-setup vs do nothing. 15 criteria compared.
decision
๐
Migration Guide
Moving from Cursor, Windsurf, Aider, or Copilot? Map your safety setup.
guide
๐ฎ
Playground
Type any command, see which hooks fire. Test before you install.
interactive
Also Available
GitHub Repository
Source code, issues, releases. Star if useful.
npm Package
2,500+ daily downloads. Zero dependencies.
Hook Registry
70 hooks from 7 projects. Search, browse, install.