This page is auto-generated from pkg/diffyml/cli/flag_metadata.go by make docs-gen. Do not edit by hand — your changes will be overwritten on the next build.

diffyml [flags] <from> <to>

Output#

FlagTypeDefaultDescription
-o, --outputstringdetailedspecify output style: compact, brief, github, gitlab, gitea, json, json-patch, detailed
-c, --colorstringautospecify color usage: always, never, or auto
-t, --truecolorstringautospecify true color usage: always, never, or auto

Comparison#

FlagTypeDefaultDescription
-i, --ignore-order-changesbool—ignore order changes in lists
--ignore-whitespace-changesbool—ignore leading or trailing whitespace changes
--format-stringsbool—canonicalize embedded JSON strings before comparison
-v, --ignore-value-changesbool—exclude changes in values
--detect-kubernetesbooltruedetect kubernetes entities
--detect-renamesbooltrueenable detection for renames
--ignore-api-versionbool—ignore apiVersion when matching Kubernetes resources
-x, --no-cert-inspectionbool—disable x509 certificate inspection
--swapbool—swap ‘from’ and ’to’ for comparison
-u, --unchangedbool—report keys equal between both files (inverse diff)

Filtering#

FlagTypeDefaultDescription
--filterlist—filter reports to a subset of differences (repeatable)
--excludelist—exclude reports from a set of differences (repeatable)
--filter-regexplist—filter reports using regular expressions (repeatable)
--exclude-regexplist—exclude reports using regular expressions (repeatable)
--additional-identifierlist—use additional identifier in named entry lists (repeatable)

Neat#

FlagTypeDefaultDescription
--neatbool—exclude well-known noisy K8s/Helm/ArgoCD/Flux paths
--no-neat-helmbool—with –neat: keep Helm-injected paths
--no-neat-argocdbool—with –neat: keep ArgoCD-injected paths
--no-neat-fluxbool—with –neat: keep Flux-injected paths
--no-neat-statusbool—with –neat: keep .status subtree and spec.nodeName
--neat-explainbool—print neat exclude regexes that fired (to stderr)
--neat-strip-pathlist—additional regex appended to the neat bundle (requires –neat; repeatable)

Masking#

FlagTypeDefaultDescription
--mask-secretsbool—auto-mask data/stringData of Kubernetes Secret resources
--mask-pathlist—additional path to mask (dot-notation, prefix match; repeatable)
--mask-path-regexplist—additional path to mask (regex; repeatable)
--mask-placeholderstring***placeholder for masked values

Display#

FlagTypeDefaultDescription
-b, --omit-headerbool—omit the diffyml summary header
-g, --use-go-patch-stylebool—use Go-Patch style paths in outputs
--multi-line-context-linesint4context lines for multi-line strings

Chroot#

FlagTypeDefaultDescription
--chrootstring—change the root level of the input file
--chroot-of-fromstring—only change the root level of the from input file
--chroot-of-tostring—only change the root level of the to input file
--chroot-list-to-documentsbool—treat chroot list as set of documents

AI Summary#

FlagTypeDefaultDescription
-S, --summarybool—enable AI-powered summary of differences (requires ANTHROPIC_API_KEY)
--summary-modelstringclaude-haiku-4-5-20251001specify Anthropic model for summary

Configuration#

FlagTypeDefaultDescription
--configstring.diffyml.ymlpath to config file

Other#

FlagTypeDefaultDescription
-s, --set-exit-codebool—set program exit code based on differences
-h, --helpbool—show help

Version#

FlagTypeDefaultDescription
-V, --versionbool—show version information

--version is handled in main.go before flag parsing, so it works even when other arguments are missing or invalid.

Backward AI Summaries