BUPSTASH-DIFF(1)                 User Commands                BUPSTASH-DIFF(1)

<?><?><?> (NAME)
       bupstash-diff - <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (stdout).

       bupstash diff [<?><?><?><?><?><?><?><?>] <?><?><?><?><?><?><?><?>... ::
       <?><?><?><?><?><?><?><?>...

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bupstash diff <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       (<?><?><?><?>) <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (diff) <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?>. <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> './'
       <?><?> '/' <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?> bupstash diff <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> diff <?><?><?> <?><?><?><?><?> bupstash
       list-contents <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?> Bupstash <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> diff
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> --ignore <?><?><?><?><?> times
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?> content
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?> <?><?><?><?><?> (OUTPUT FORMAT)
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> bupstash list-contents
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> + <?><?> -
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> --format <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       bupstash-list-contents(1) <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> + <?><?> - <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

<?><?><?><?> <?><?><?><?><?><?><?> (QUERY LANGUAGE)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> bupstash-query-language(7)
       <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (QUERY CACHING)
       <?><?><?><?><?> diff <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       (<?><?><?><?><?> <?><?><?><?>) <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       bupstash-list(1) <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --repository REPO
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> ssh <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              ssh://$SERVER/$PATH <?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              BUPSTASH_REPOSITORY <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -k, --key KEY
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?>. <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> BUPSTASH_KEY <?><?><?>.

       --query-cache PATH
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (query-cache)<?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?>: $BUPSTASH_QUERY_CACHE
              <?><?> $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache <?><?>
              $HOME/.cache/bupstash/bupstash.qcache.

       -i, --ignore
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              (<?><?><?><?>) <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:
              'content,dev,devnos,inode,type,perms,nlink,uid,gid,times,xattrs'

       --relaxed
              <?><?><?><?><?><?><?><?> <?><?><?><?> --ignore
              'dev,inode,nlink,uid,gid,times,xattrs' <?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       --{left,right}-pick PATH
              <?><?><?><?><?> <?><?><?><?><?><?> (diff) <?><?> <?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>.

       --indexer-threads N
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> (threads) <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.

       --xattrs
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> (xattrs) <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.

       --format FORMAT
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?> <?><?><?><?><?> 'human' <?><?> 'jsonl'.

       --utc-timestamps
              <?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> (UTC) <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?>.

       --no-progress
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?> stderr <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>).

       -q, --quiet
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> --no-progress
              <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?> (ENVIRONMENT)
       BUPSTASH_REPOSITORY
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?>. <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> ssh <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              ssh://$SERVER/$PATH <?><?><?><?>.

       BUPSTASH_REPOSITORY_COMMAND
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
              bupstash-serve(1).  <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       BUPSTASH_KEY
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?>.

       BUPSTASH_KEY_COMMAND
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?> BUPSTASH_KEY <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>.

       BUPSTASH_QUERY_CACHE
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (query cache) <?><?><?>
              <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?>
       $ bupstash diff id="14eb*" :: id="57de*"
       - -rw-r--r-- 1.1kB hello.txt
       + -rw-r--r-- 1.3kB goodbye.txt

   <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       $ bupstash diff --left-pick files --relaxed id="57de*" :: ./files

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bupstash(1), bupstash-list(1), bupstash-keyfiles(7),
       bupstash-query-language(7)

bupstash                          2026-09-01                  BUPSTASH-DIFF(1)