Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/mubshrx/git-snapshot/llms.txt

Use this file to discover all available pages before exploring further.

The show command displays detailed metadata and file listings for a specific snapshot.

​
Syntax

git-snapshot show <name>

​
Parameters

  • name: The snapshot name, hash, or partial identifier to display

​
Output format

The command displays:
  1. Snapshot metadata (name, hash, repo, branch, commit, creation time)
  2. List of staged files
  3. List of unstaged files
  4. List of untracked files

​
Examples

​
Show by name

git-snapshot show my-feature
Output: 
Snapshot: my-feature.a1b2c3d4.snapshot
Hash: a1b2c3d4
Name: my-feature
Repo: my-project
Branch: main
Commit: 7f3e9a2b
Created: 2026-03-03 14:23:45

Staged files:
  src/auth.js
  src/utils.js

Unstaged files:
  README.md

Untracked files:
  config/local.json
  test/new-test.js
  .env.local

​
Show by hash

git-snapshot show a1b2c3d4
Output is the same as showing by name.

​
Show snapshot with no changes in a category

git-snapshot show quick-save
Output: 
Snapshot: quick-save.b5c6d7e8.snapshot
Hash: b5c6d7e8
Name: quick-save
Repo: my-project
Branch: develop
Commit: 4a8d9e1c
Created: 2026-03-02 10:15:30

Staged files:
  (none)

Unstaged files:
  src/main.js
  src/config.js

Untracked files:
  (none)

​
Matching behavior

The show command can match snapshots by:
  1. Exact name: my-feature matches my-feature.a1b2c3d4.snapshot
  2. Hash: a1b2c3d4 matches my-feature.a1b2c3d4.snapshot
  3. Full filename: my-feature.a1b2c3d4 matches my-feature.a1b2c3d4.snapshot
Unlike other commands, show searches across all repositories, not just the current one. This allows you to inspect snapshots from any repo.

​
Multiple matches

If multiple snapshots match the query, the command lists all matches and asks you to be more specific: 
git-snapshot show feature
Output: 
Multiple snapshots match 'feature':

  [1] a1b2c3d4  main  2026-03-03 14:23:45
  [2] b5c6d7e8  develop  2026-03-02 10:15:30

Specify the hash to show a specific snapshot
To resolve this, use the specific hash: 
git-snapshot show a1b2c3d4

​
Error handling

​
Snapshot not found

git-snapshot show nonexistent
Output: 
Error: Snapshot 'nonexistent' not found

​
Missing parameter

git-snapshot show
Output: 
Error: Please provide a snapshot name or hash
Usage: git-snapshot show <name>

Build docs developers (and LLMs) love

Get started for freeTalk to us