Getting started

Zero to first validation in five minutes

On this page

Overview

klaudiush is a validation dispatcher for Claude Code hooks. It intercepts tool calls (git commits, file writes, bash commands) and validates them against configurable rules before they execute. This guide covers install and your first validated commit.

Install klaudiush

The fastest way to install is Homebrew on macOS/Linux. The install script works on any platform. See the installation guide for Nix, from-source builds, and other options.

# macOS / Linux (Homebrew)
brew install smykla-skalski/tap/klaudiush

# Or use the install script
curl -sSfL https://klaudiu.sh/install.sh | sh

After installing, run the init command. It creates a global config and registers the hooks in ~/.claude/settings.json automatically.

# Create global config with interactive prompts
klaudiush init --global

# Verify setup
klaudiush doctor

Hook timeout

File validators (markdown, terraform, shellcheck) run external tools. Set the hook timeout to at least 30 seconds if you enable them.

First validation

With the hook configured, klaudiush runs automatically when Claude Code uses tools. Try a git commit - klaudiush validates the command, commit message, and staging area.

# Try a commit - klaudiush validates automatically
git commit -sS -m "feat(api): add user endpoint"

# If validation fails, you'll see the error code and fix hint
# Example: [GIT001] Missing signoff flag. Add -sS to your commit command.

If validation fails, Claude Code sees the error code, a message explaining the issue, and a fix hint. It can then self-correct and retry with a valid command.

What's next

You have a working setup with default validators. From here you can:

© 2026 Smykla Skalski Labs