status

Display what files have changed in the working tree from the latest snapshot

Usage

aegis status [OPTIONS]

Options

Option	Description
--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.
--fail-on-changes	Returns a non-zero status code if there are any changes in the working tree. This is useful to incorporate aegis in shell scripts. For example: if aegis status --fail-on-changes; then echo "Ok!"; else echo "Need snapshot!"; fi

Description

The status command compares your current working directory against the latest snapshot and shows all differences. This lets you review changes before creating a new snapshot.

By default, aegis uses file size and modification time to detect changes (fast). Use --checksum to compute actual checksums for all files (slower but can detect bit rot).

Output

Changes are displayed as a list of files that differ from the last snapshot with labels:

• Dir added
• Dir removed
• File added
• File modified
• File removed
• File renamed
• File metadata updated (File timestamp has changed, but content remains same)
• Link added
• Link modified
• Link removed

Examples

aegis status

Output:

   File added documents/report.pdf
File modified music/.sticker.sql
 File removed notes.txt