NOTMUCH-SEARCH(1)                   notmuch                  NOTMUCH-SEARCH(1)

<?><?><?> (NAME)
       notmuch-search - <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       notmuch search [option ...] <search-term> ...

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> (threads)
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (thread ID)<?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> (<?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>) <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       (<?><?> <?><?><?><?><?><?><?><?><?><?>) <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <search-terms><?> <?><?> notmuch-search-terms <#notmuch-
       search-terms-7> <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> search <?><?><?><?><?><?><?><?><?> <?><?>:

       --format=(json|sexp|text|text0)
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> JSON<?>
              <?><?><?><?><?><?><?><?><?> <?><?> (S-Expressions)<?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?> (<?><?><?><?><?><?><?>)<?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?> (null) (<?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              -0 <?><?> xargs(1) <https://manpages.debian.org/xargs.1.html>
              <?><?> <?><?><?><?> <?><?><?><?>) <?><?><?><?><?>
              <?><?><?><?><?><?>.

       --format-version=N
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> notmuch <#notmuch-1>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?>.

       --output=(summary|threads|messages|files|tags)

              summary (default)
                     <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?><?>
                     <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                     <?><?><?><?> (<?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?>
                     <?><?><?><?><?> <?><?>)<?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?> <?> <?><?><?><?><?> <?><?><?>. <?><?>
                     <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
                     <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
                     (<?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
                     <?><?><?><?><?><?> <?><?><?><?>).

              threads
                     <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?> <?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?> <?><?> <?><?> <?><?> (--format=text)<?>
                     <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?> (--format=text0)<?> <?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?> JSON (--format=json)<?>
                     <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                     S-Expression (--format=sexp).

              messages
                     <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
                     <?><?> <?><?> (--format=text)<?> <?><?><?><?><?><?>
                     <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
                     (--format=text0)<?> <?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?> JSON (--format=json)<?>
                     <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                     S-Expression (--format=sexp).

              files  <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
                     <?><?> (--format=text)<?> <?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?> (--format=text0)<?>
                     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> JSON
                     (--format=json)<?> <?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?> S-Expression (--format=sexp).

                     <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
                     <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
                     <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?>. <?><?><?><?>
                     <?><?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?>
                     <?><?><?><?><?> <?><?> <?><?><?><?><?><?> --duplicate=N
                     <?><?><?><?><?> <?><?><?> <?><?><?><?><?>). <?><?><?>
                     <?><?><?><?><?> <?><?><?><?> <?><?><?>
                     <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
                     folder: <?><?> path: <?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

              tags   <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                     <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
                     <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
                     <?><?> (--format=text)<?> <?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?> (--format=text0)<?>
                     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> JSON
                     (--format=json)<?> <?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?> S-Expression (--format=sexp).

       --sort=(newest-first|oldest-first)
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> (oldest-first) <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (newest-first)
              <?><?><?><?><?><?><?> <?><?><?>.

              <?><?><?><?>: <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> (<?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>). <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> oldest-first<?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              newest-first<?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?>.

              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>).

       --offset=[-]N
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> N
              <?><?><?><?><?><?> <?><?><?><?>. <?><?> <?><?><?> '-' <?><?>
              <?><?><?><?><?><?> <?><?> N<?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --limit=N
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> N.

       --exclude=(true|false|all|flag)
              <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <<<?><?><?><?><?><?><?><?><?><?>>> ("excluded")
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              search.exclude_tags <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?>.

              true (default)
                     <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                     <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

              all    <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
                     <?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?>
                     <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

              false  <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                     <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
                     <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>.
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?>.

              flag   <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                     <?><?> --output=summary <?><?><?><?>. <?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?> false <?><?><?><?><?>
                     <?><?><?><?> <?><?><?> <<<?><?><?><?><?>
                     <?><?><?><?><?><?>>> ("match count") <?><?><?><?><?>
                     <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
                     <?><?><?><?> <?><?><?><?> <?><?> <?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       --duplicate=N
              <?><?><?><?> --output=files<?> <?><?><?> <?><?><?><?> N<?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> (N
              <?><?> <?><?><?><?><?> <?> <?><?><?>). <?><?><?> N
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>.

              <?><?><?><?> --output=messages<?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?> <?><?><?><?><?> N <?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> folder: <?><?><?> <?><?><?><?><?><?>. <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> summary <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?>.

          % notmuch search date:today.. and tag:bad-news
          thread:0000000000063c10 Today [1/1] Some Persun; To the bone (bad-news inbox unread)
          thread:0000000000063c25 Today [1/1(2)] Ann Other; Bears (bad-news inbox unread)
          thread:0000000000063c00 Today [1/1] A Thurd; Bites, stings, sad feelings (bad-news unread)

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>:

       20     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?><?> <?><?><?>.

       21     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       notmuch <#notmuch-1>, notmuch-address <#notmuch-address-1>
       notmuch-config <#notmuch-config-1>, notmuch-count <#notmuch-count-1>,
       notmuch-dump <#notmuch-dump-1>, notmuch-hooks <#notmuch-hooks-5>,
       notmuch-insert <#notmuch-insert-1>, notmuch-new <#notmuch-new-1>,
       notmuch-reply <#notmuch-reply-1>, notmuch-restore <#notmuch-restore-1>,
       notmuch-search-terms <#notmuch-search-terms-7>, notmuch-show <#notmuch-
       show-1>, notmuch-tag <#notmuch-tag-1>

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Carl Worth <?> <?><?><?><?><?><?> <?><?><?><?>

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       2009-2026, Carl Worth <?> <?><?><?><?><?><?> <?><?><?><?>

0.40                            April 17, 2026               NOTMUCH-SEARCH(1)