Back to all errors

GIT001

GIT

Missing signoff flag

Error

Git commit is missing the -s or --signoff flag.

Why this matters

The signoff flag adds a Signed-off-by trailer to your commit message, certifying that you have the right to submit the code under the project's license (Developer Certificate of Origin).

How to fix

Add the -s flag to your git commit command:

# Instead of:
git commit -m "message"

# Use:
git commit -sS -m "message"

Configuration

Disable this check in config.toml:

[validators.git.commit]
required_flags = ["-S"]  # Only require GPG signing, not signoff

Or disable entirely:

[validators.git.commit]
required_flags = []

Hook output

When this error is triggered, klaudiush writes JSON to stdout:

permissionDecisionReason (shown to Claude): [GIT001] Git commit is missing the -s (signoff) flag. Add -s flag: git commit -sS -m "message"

systemMessage (shown to user): Formatted error with fix hint and reference URL.

additionalContext (behavioral guidance): Automated klaudiush validation check. Fix the reported errors and retry the same command.

  • GIT002 - Missing GPG signing flag
  • GIT010 - Missing required flags (combined)

© 2026 Smykla Skalski Labs