git bundle list-heads <filepath>

This command helps you inspect a Git bundle file by listing each stored reference’s commit hash and name so you can quickly see which branches and tags are included.

The list-heads action reads a bundle’s header without unpacking its contents and <filepath> designates the path to your bundle file, while the optional -v (or --verbose) flag adds extra details such as object types or annotated tags.

You can pass multiple bundles at once using git bundle list-heads a.bundle b.bundle, use git bundle verify <filepath> to confirm the bundle can be applied cleanly, or for checking references in a live repository consider git ls-remote <repo-url> or inspecting local refs with git show-ref.

Examples:

• git bundle list-heads repo.bundle
• git bundle list-heads /path/to/backup.bundle