Configuration files

Updated Jul 21, 2026

The hook loads configuration from these locations, highest precedence first:

  1. The --config <path> file.
  2. .post-turn-quality.toml in the repository root.
  3. ${XDG_CONFIG_HOME:-$HOME/.config}/post-turn-quality-stop-hook/config.toml.
  4. Built-in defaults.

All gates are enabled by default:

gate_quality_checks = true
gate_uncommitted_changes = true
gate_unpushed_commits = true
gate_pr_rebase = true
base_branch_default = "main"
protected_branches = ["trunk", "main", "release", "master"]
github_timeout_seconds = 3.0

Omit primary_remote to let the hook choose the primary remote. Unknown keys block the stop before the hook contacts the network or runs build commands.