Claude Code Boost

Claude Code Boost

Smart hooks for Claude Code that reduce friction and keep quality high.

- Auto-approve safe dev operations (less clicking, more coding)
- Nudge/run tests before ending sessions when changes warrant it
- Optional desktop notifications for long-running tasks

Quick Start

See what gets auto-approved and blocked in the sections below.

Installation

Prerequisites: Node.js 20+ and Claude Code installed

The ccb install command guides you through:
1. Choose installation location (user, project, or project-local settings)
2. Choose authentication method (API proxy or direct API key)
3. Configure Claude Code settings automatically
4. Verify the setup works

Feature Details

Auto-Approval Hook
Reduces manual approval overhead by automatically approving common safe operations:
- File operations (reading, writing, basic file management)
- Standard build/test commands (npm test, npm build, git commit)
- Local development requests (curl localhost:3000)
- Package management (npm install, dependency updates)
- Basic Docker operations

Always blocks destructive system commands (rm -rf /, disk formatting, etc.)

Test Enforcement Hook
Analyzes conversation transcripts to detect when tests should be run before ending a session:
- Parses Claude Code conversation history
- Uses LLM analysis to determine if code changes warrant testing
- Can block session termination until tests are executed

Notification Hook
Simple desktop notifications for Claude Code events:
- Cross-platform support (macOS, Windows, Linux)
- Useful for long-running operations or important alerts

Transcript Parser
Utility for processing Claude Code conversation logs:
- Converts JSONL transcript format to structured XML
- Extracts user messages, assistant responses, and commands
- Useful for analysis…