Husky-style hooks and skills management for Claude Code
npm install claude-autoHusky-style hooks and skills management for Claude Code.
   ![TypeScript]()
---
Without Claude Auto, you babysit every AI coding session. You watch, nudge, correct, and context-switch constantly. One task at a time, full attention required.
Claude Auto installs a quality loop into Claude Code via hooks. Validators gate every commit. Reminders inject your guidelines into every prompt. Deny-lists protect files from modification. Auto-continue keeps the agent working until the plan is done. The system earns trust, and trust enables parallelization via git worktrees.
- Hooks: Four integration points (SessionStart, PreToolUse, UserPromptSubmit, Stop) that let Claude Auto observe and control Claude Code's behavior
- Validators: Markdown files with YAML frontmatter that ACK or NACK commits based on your criteria
- Reminders: Context-injection files that surface your guidelines at the right moment
- Deny-list: Glob patterns that protect files from modification
- TCR Discipline: Test && Commit || Revert. Bad code auto-reverts
- Auto-Continue: Keeps the agent going until the plan is done
---
``bash`
npx claude-auto install
`bash`
npx claude-auto install
npx claude-auto doctor
After installation, Claude Auto automatically:
- Injects hooks that validate every commit against your criteria
- Creates reminders that inject your guidelines into prompts
- Sets up file protection via deny-lists
- Merges settings with smart project/local overrides
Next steps:
- Getting Started guide
- The Ketchup Technique
---
`bash`
npx claude-auto doctor
`bash`
npx claude-auto repair
`bash`
npx claude-auto reminders
`bash`
npx claude-auto install --non-interactive
`bash
git worktree add ../feature-auth feature/auth
git worktree add ../feature-payments feature/payments
cd ../feature-auth && npx claude-auto install
cd ../feature-payments && npx claude-auto install
`
Each worktree runs its own Claude Auto instance, all quality-validated.
---
#### claude-auto install
Install and configure Claude Auto in your project.
`bash`
claude-auto install [target-path] [options]
| Option | Type | Default | Description |
| ------ | ---- | ------- | ----------- |
| --local | boolean | false | Use development mode (runs TypeScript source directly via tsx) |
#### claude-auto doctor
Verify every expected symlink is valid and report issues.
`bash`
claude-auto doctor
#### claude-auto status
Show symlink status for hook scripts, validators, and reminders.
`bash`
claude-auto status
#### claude-auto repair
Recreate broken or missing symlinks between the package and project directories.
`bash`
claude-auto repair
#### claude-auto reminders
List active reminders with name, hook, and priority metadata.
`bash`
claude-auto reminders
#### claude-auto clean-logs
Remove old log files from the logs directory.
`bash`
claude-auto clean-logs [options]
| Option | Type | Default | Description |
| ------ | ---- | ------- | ----------- |
| --older-than | number | 60 | Keep logs newer than N minutes |
#### claude-auto tui
Launch the full-screen terminal UI with live log tailing.
`bash`
claude-auto tui
`json`
{
"autoContinue": { "mode": "smart" },
"validateCommit": { "mode": "strict", "batchCount": 3 },
"denyList": { "enabled": true },
"promptReminder": { "enabled": true },
"subagentHooks": {
"validateCommitOnExplore": false,
"validateCommitOnWork": true,
"validateCommitOnUnknown": true
}
}
Configuration lives in .claude-auto/.claude.hooks.json. See the Configuration guide for all options.
Settings merge in priority order:
1. templates/settings.json (package defaults).claude/settings.project.json
2. (team overrides).claude/settings.local.json
3. (personal overrides)
---
`mermaid`
flowchart LR
A[Claude Code] --> B[Hook Scripts]
B --> C{Hook Type}
C -->|SessionStart| D[Load Reminders]
C -->|PreToolUse| E[Validate Commits + Deny-list]
C -->|UserPromptSubmit| F[Inject Reminders]
C -->|Stop| G[Auto-Continue Decision]
E -->|ACK| H[Allow]
E -->|NACK| I[Block + Revert]
Hook scripts read JSON from stdin, delegate to handlers in src/hooks/, log results, and output JSON to stdout. Validators are batched (default 3 per Claude CLI call) for efficient parallel validation. Reminders are matched by hook type, mode, and tool name, then injected as blocks.
---
Symptom: claude-auto: command not found
Cause: Package not installed globally or not in PATH.
Solution:
`bash`
npx claude-auto install
Symptom: Commits go through without validation.
Cause: Settings not merged or symlinks broken.
Solution:
`bash`
npx claude-auto doctor
npx claude-auto repair
`bash`
DEBUG=claude-auto npx claude-auto install
Debug logs write to .claude-auto/logs/claude-auto/debug.log.
---
| Guide | Description |
| ----- | ----------- |
| Getting Started | First-time setup and core concepts |
| Installation | Detailed installation guide |
| The Ketchup Technique | The planning methodology |
| Configuration | All configuration options |
| Hooks Guide | Hook system deep-dive |
| Reminders Guide | Context injection system |
| Validators Guide | Commit validation rules |
| API Reference | Programmatic access |
| Architecture | System design internals |
| Origin Story | How Claude Auto came to be |
---
`
src/
├── cli/ # CLI commands (install, doctor, repair, status, reminders, tui)
│ └── tui/ # Full-screen terminal UI with live log tailing
├── hooks/ # Hook handlers (session-start, pre-tool-use, user-prompt-submit, auto-continue)
├── commit-validator.ts # Batched commit validation with appeal support
├── config-loader.ts # Cosmiconfig-based configuration
├── deny-list.ts # File protection via micromatch patterns
├── reminder-loader.ts # Markdown + YAML frontmatter reminder system
├── settings-merger.ts # Three-layer settings merge with lock-file caching
├── hook-state.ts # Hook state management (.claude.hooks.json)
├── validator-loader.ts # Markdown validator loader
└── index.ts # Public API barrel exports
scripts/
├── session-start.ts # SessionStart hook entry-point
├── pre-tool-use.ts # PreToolUse hook entry-point
├── user-prompt-submit.ts # UserPromptSubmit hook entry-point
└── auto-continue.ts # Stop hook entry-point
| Package | Usage |
| ------- | ----- |
| commander | CLI framework |
| cosmiconfig | Configuration file discovery |
| gray-matter | YAML frontmatter parsing for validators and reminders |
| micromatch | Glob pattern matching for deny-lists |
---
- Node.js 18+
- pnpm 10+
`bash`
git clone https://github.com/BeOnAuto/claude-auto.git
cd claude-auto
pnpm install
pnpm build
| Command | Description |
| ------- | ----------- |
| pnpm build | TypeScript compile + esbuild bundle scripts |pnpm test
| | Run all tests (vitest) |pnpm type-check
| | TypeScript type checking |pnpm lint
| | Biome lint check |pnpm check` | Full CI: build + type-check + test + lint |
|
---
MIT © 2025 BeOnAuto, Inc.
See LICENSE for details.