Environment variables

Every KLAUDIUSH_ var and standard vars

On this page

Overview
KLAUDIUSH_ variables
Standard variables
Precedence

Overview

Every TOML config option has a corresponding environment variable. Variables use the KLAUDIUSH_ prefix and follow the TOML structure with underscores replacing dots. Environment variables take precedence over config files but are overridden by CLI flags.

KLAUDIUSH_ variables

Validators

Git Add

`KLAUDIUSH_VALIDATORS_GIT_ADD_ENABLED`	Enable git add validator
`KLAUDIUSH_VALIDATORS_GIT_ADD_BLOCKED_PATTERNS`	Comma-separated blocked file patterns

Git Commit

`KLAUDIUSH_VALIDATORS_GIT_COMMIT_ENABLED`	Enable git commit validator
`KLAUDIUSH_VALIDATORS_GIT_COMMIT_REQUIRED_FLAGS`	Required commit flags (e.g. `"-s,-S"`)
`KLAUDIUSH_VALIDATORS_GIT_COMMIT_MESSAGE_TITLE_MAX_LENGTH`	Max commit title length (default 50)
`KLAUDIUSH_VALIDATORS_GIT_COMMIT_MESSAGE_BODY_MAX_LINE_LENGTH`	Max commit body line length (default 72)
`KLAUDIUSH_VALIDATORS_GIT_COMMIT_MESSAGE_CHECK_CONVENTIONAL_COMMITS`	Enforce conventional commit format
`KLAUDIUSH_VALIDATORS_GIT_COMMIT_MESSAGE_REQUIRE_SCOPE`	Require scope in conventional commits

Git Push

KLAUDIUSH_VALIDATORS_GIT_PUSH_ENABLED Enable git push validator

Git PR

`KLAUDIUSH_VALIDATORS_GIT_PR_ENABLED`	Enable git PR validator
`KLAUDIUSH_VALIDATORS_GIT_PR_TITLE_MAX_LENGTH`	Max PR title length (default 50)

Git Branch

`KLAUDIUSH_VALIDATORS_GIT_BRANCH_ENABLED`	Enable git branch validator
`KLAUDIUSH_VALIDATORS_GIT_BRANCH_PROTECTED_BRANCHES`	Comma-separated protected branch names

Markdown

`KLAUDIUSH_VALIDATORS_FILE_MARKDOWN_ENABLED`	Enable markdown validator
`KLAUDIUSH_VALIDATORS_FILE_MARKDOWN_TIMEOUT`	Markdown validator timeout

Shellscript

`KLAUDIUSH_VALIDATORS_FILE_SHELLSCRIPT_ENABLED`	Enable shellscript validator
`KLAUDIUSH_VALIDATORS_FILE_SHELLSCRIPT_TIMEOUT`	Shellscript validator timeout

Terraform

`KLAUDIUSH_VALIDATORS_FILE_TERRAFORM_ENABLED`	Enable terraform validator
`KLAUDIUSH_VALIDATORS_FILE_TERRAFORM_CHECK_FORMAT`	Check terraform formatting

Workflow

`KLAUDIUSH_VALIDATORS_FILE_WORKFLOW_ENABLED`	Enable workflow validator
`KLAUDIUSH_VALIDATORS_FILE_WORKFLOW_ENFORCE_DIGEST_PINNING`	Enforce digest pinning in workflows

Other

`KLAUDIUSH_USE_SDK_GIT`	Use go-git SDK instead of git CLI
`KLAUDIUSH_LOG_FILE`	Custom log file path (overrides XDG state directory)
`KLACK`	Exception token (`EXC:CODE:reason`)

Standard variables

klaudiush also respects these standard environment variables:

`NO_COLOR`	Disable colored output (any non-empty value)
`GH_TOKEN`	GitHub API token for workflow validator and self-update (avoids rate limits)
`GITHUB_TOKEN`	Alias for GH_TOKEN. Falls back to `gh auth token` if neither is set
`XDG_CONFIG_HOME`	XDG config base directory (default `~/.config`)
`XDG_DATA_HOME`	XDG data base directory (default `~/.local/share`)
`XDG_STATE_HOME`	XDG state base directory (default `~/.local/state`)

Precedence

From highest to lowest precedence:

CLI flags (--disable=commit)
Environment variables (KLAUDIUSH_VALIDATORS_GIT_COMMIT_ENABLED=false)
Project config (.klaudiush/config.toml)
Global config ($XDG_CONFIG_HOME/klaudiush/config.toml)
Built-in defaults

Value types

Type	Format	Example
Boolean	`true`, `1`, `yes`, `on` (or `false`, `0`, `no`, `off`)	`KLAUDIUSH_VALIDATORS_GIT_COMMIT_ENABLED=true`
Duration	`10s`, `30s`, `1m`, `5m30s`	`KLAUDIUSH_VALIDATORS_FILE_MARKDOWN_TIMEOUT=10s`
String list	Comma-separated, no spaces	`KLAUDIUSH_VALIDATORS_GIT_COMMIT_REQUIRED_FLAGS="-s,-S"`