KAPSULE(1)

NAME
kapsule - create and inspect ptar archives

SYNOPSIS
kapsule [-c cores] [-f archive] subcommand ...

DESCRIPTION
kapsule is a program that exposes most of the plakar(1) sub‑commands while operating on a ptar archive instead of a live Plakar repository. It transparently mounts the archive as an in‑memory, read-only repository and tears it down when the command finishes, allowing all supported Plakar functionality such as inspection, restore or diff without first extracting the archive.

The following additional positional argument is recognised:

archive
    Path to the ptar archive to operate on. Use a single dash ‘-’ to denote the standard input/output stream.

Unless stated otherwise all Plakar options behave the same when used through kapsule.

SUPPORTED COMMANDS
The wrapper exposes the following Plakar sub‑commands:

archive
cat
check
create
diff
digest
help
info
locate
ls
mount
restore
server
ui
version

ENVIRONMENT

KAPSULE_PASSPHRASE
    Passphrase used to unlock the encrypted archive.

EXAMPLES
Inspect the list of snapshots inside an archive:

    $ kapsule -f backup.ptar ls

Create a new snapshot of the current directory:

    $ kapsule -f backup-new.ptar create .

Restore the file “notes.md” from snapshot “abcd” inside the archive:

    $ kapsule -f backup.ptar restore -to . abcd:notes.md

SEE ALSO
plakar(1), ptar(5)