Config file

# Commit a zerv.toml at your repo root (stable fields only)
cat > zerv.toml <<'EOF'
source          = "stdin"
output_template = "v{{ major }}.{{ minor }}.{{ patch }}"
EOF

# zerv reads zerv.toml automatically; no flags repeated
# (stdin carries the version payload; in a git repo use source = "git")
zerv version
# → v1.2.3

# Shared-top fields shape flow too
zerv flow --schema standard
# → v1.2.3

# A CLI flag still wins over the file
zerv version --output-template "release-{{ major }}"
# → release-1

CLI flag  >  --config-file <path>  >  discovered zerv.toml  >  builtin default

# An explicit --config-file is read instead of discovering zerv.toml
cat > explicit.toml <<'EOF'
source          = "stdin"
output_template = "EXPL{{ major }}"
EOF

zerv --config-file ./explicit.toml version
# → EXPL1

# The null device disables all config (the empty file yields no overrides).
# /dev/null on Unix and macOS, NUL on Windows.
zerv --config-file /dev/null version
# → 1.2.3

# shared top: applies to every subcommand
source          = "stdin"
output_format   = "semver"
output_template = "v{{ major }}.{{ minor }}.{{ patch }}"
schema          = "standard-context"

[version]                 # optional: override the shared schema for `version` only
schema = "standard-no-context"

[flow]                    # flow-only stable policy
post_mode         = "tag"
pre_release_label = "beta"
hash_branch_len   = 7