# Command reference

Every `snapdir` subcommand shares a common set of global options and reads the same
`SNAPDIR_*` environment variables. The [overview](overview.md) documents that
shared surface — global flags, environment variables, and store URI schemes — while
each page below covers a single subcommand.

- [Overview](overview.md) — global options, `SNAPDIR_*` environment variables, and
  store URI schemes.

## Snapshotting

- [`snapdir manifest`](snapdir-manifest.md) — print the manifest of a directory.
- [`snapdir id`](snapdir-id.md) — print the manifest ID of a directory or a piped
  manifest.
- [`snapdir stage`](snapdir-stage.md) — save a snapshot of a directory into the
  local cache.

## Distributing

- [`snapdir push`](snapdir-push.md) — push a snapshot to a store.
- [`snapdir fetch`](snapdir-fetch.md) — fetch a snapshot from a store into the
  local cache.
- [`snapdir pull`](snapdir-pull.md) — fetch a snapshot from a store and check it
  out.
- [`snapdir checkout`](snapdir-checkout.md) — check out a snapshot to a directory.
- [`snapdir sync`](snapdir-sync.md) — copy a snapshot directly between two stores.

## Verifying

- [`snapdir verify`](snapdir-verify.md) — verify the integrity of a staged
  snapshot.
- [`snapdir verify-cache`](snapdir-verify-cache.md) — verify the integrity of the
  local cache.
- [`snapdir flush-cache`](snapdir-flush-cache.md) — flush the local cache.

## Catalog and history

- [`snapdir locations`](snapdir-locations.md) — list directories and stores where
  snapshots have been recorded.
- [`snapdir ancestors`](snapdir-ancestors.md) — list ancestor snapshot IDs and
  their locations.
- [`snapdir revisions`](snapdir-revisions.md) — list snapshot IDs created on a
  location.

## Other

- [`snapdir defaults`](snapdir-defaults.md) — print default settings and arguments.
- [`snapdir version`](snapdir-version.md) — print the version.