ls
List a directory in the configured backend
Usage
aegis ls [OPTIONS] [PATH]
Arguments
| Argument | Description |
|---|---|
PATH | The path to list |
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 |
--snapshot | A query specifying the snapshot to use.
This can be "latest", a snapshot root checksum, or an index number.
Use aegis list-snapshots --backend {backend name} to get checksums/indexes.
(default: |
--recursive, -r | Whether to recursively print the entire tree |
Description
The ls command displays the contents of a directory in the latest snapshot. This lets you
browse your archived files without restoring them.
Output is displayed as a tree structure.
Examples
List Root Directory:
aegis ls
Output:
/
├─ documents/
├─ music/
├─ photos/
└─ aegis.toml
List a Subdirectory
aegis ls music
Output:
music
├─ playlists/
├─ artists/
└─ .sticker.sql
List from a Specific Backend:
aegis ls --backend cloud