snapshot

Create a new snapshot on the configured backend with changes from the working tree

Usage

aegis snapshot [OPTIONS]

Options

OptionDescription
--repo

Specify a path to a repo to use instead of the current working directory

--backend

Use a specific backend instead of the one specified by default_backend in aegis.toml

--checksum, -c

Compute the diff using checksum for all files instead of size and modified time. Doing this is much slower but can detect bit rot in your working directory.

Description

The snapshot command creates a point-in-time backup of your files. It:

  1. Computes the difference between your working directory and the latest snapshot
  2. Shows you the changes (same output as status)
  3. Asks for confirmation
  4. Uploads new or modified files (with deduplication)
  5. Creates a new snapshot record

If there are no changes, nothing is uploaded and no snapshot is created.

Examples

# Create a Snapshot:
aegis snapshot

# Snapshot with Checksum Verification (useful for detecting bit rot in your working dir):
aegis snapshot --checksum

# Snapshot to a Specific Backend:
aegis snapshot --backend cloud