klaudiush

Validation dispatcher for Claude Code hooks

Intercepts tool invocations and enforces git workflow standards and code quality rules before execution.

Git workflow

Commit message format, required flags (-sS), staging validation, push policies, branch naming, PR checks.

File quality

Shellcheck, markdownlint, terraform fmt, tflint, actionlint, gofumpt, ruff, oxlint, rustfmt.

Secret detection

25+ regex patterns for AWS, GitHub tokens, private keys, connection strings. Optional gitleaks integration.

Dynamic rules

TOML configuration, glob/regex pattern matching, priority system, per-validator scoping. No code changes needed.

Bash parsing

AST parsing via mvdan.cc/sh. Command chains, pipes, subshells, redirections, heredocs, file write detection.

Performance

~60ms cold start, <25us parser, <50ms per validator, <115ms full chain, <11us per rule evaluation.

Installation

Homebrew

brew install smykla-skalski/tap/klaudiush

Install script

curl -sSfL https://klaudiu.sh/install.sh | sh

Then run the setup wizard (registers the hook and creates config):

klaudiush init --global

Also available via Nix and from source. See the GitHub README for all options.

Documentation

Guides for rules, backups, plugins, and exceptions.

Examples

Ready-to-use config files, rules, and plugin templates.

Error reference

Browse all error codes with explanations and fix instructions.