> ## Content Index
> Fetch the complete content index at: https://www.namastesalesforce.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# sfdx-org-snapshot
- URL: https://www.namastesalesforce.com/projects/sfdx-org-snapshot/
- Published: 2026-03-15T09:00:00.000Z
- Updated: 2026-03-15T09:00:00.000Z
- Description: CLI that snapshots an org's metadata and sample data into versioned JSON — diff two snapshots to see what actually changed between refreshes.
- Author: Swarnil Singhai
- Tags: DevOps, #project, #project-lang-python, #project-stars-57, #Import 2026-09-03 19:13

CLI that snapshots an org's metadata and sample data into versioned JSON — diff two snapshots to see what actually changed between refreshes.

## What it does

sfdx-org-snapshot pull captures metadata plus a configurable sample of records per object into a content-addressed JSON tree; diff renders what changed between any two snapshots as a readable report.

## Install

pipx install sfdx-org-snapshot, authenticate with your existing sf CLI session, and add the pull to your post-refresh script. Snapshots are plain files — commit them, diff them, grep them.

## Design notes

Records are sampled deterministically (newest N per object, IDs redacted on request) so two pulls of an unchanged org produce identical trees — which is what makes the diffs mean something.