NAME

       notmuch-reply - constructs a reply template for a set of messages

SYNOPSIS

       notmuch reply [options...] <search-term>...

DESCRIPTION

       Constructs a reply template for a set of messages.

       To  make  replying  to  email  easier,  notmuch  reply takes an existing set of messages and constructs a
       suitable mail template. The Reply-to: header (if any, otherwise From:)  is  used  for  the  To:  address.
       Unless  --reply-to=sender is specified, values from the To: and Cc: headers are copied, but not including
       any of the current  user's  email  addresses  (as  configured  in  primary_mail  or  other_email  in  the
       .notmuch-config file) in the recipient list.

       It  also  builds  a suitable new subject, including Re: at the front (if not already present), and adding
       the message IDs of the messages being replied to to the References  list  and  setting  the  In-Reply-To:
       field correctly.

       Finally,  the original contents of the emails are quoted by prefixing each line with '> ' and included in
       the body.

       The resulting message template is output to stdout.

       Supported options for reply include

              --format=(default|json|sexp|headers-only)

                  default
                      Includes subject and quoted message body as an RFC 2822 message.

                  json
                      Produces JSON output containing headers for a  reply  message  and  the  contents  of  the
                      original  message.  This  output  can  be  used  by  a  client  to  create a reply message
                      intelligently.

                  sexp
                      Produces S-Expression output containing headers for a reply message and  the  contents  of
                      the  original  message.  This  output  can  be  used by a client to create a reply message
                      intelligently.

                  headers-only
                      Only produces In-Reply-To, References, To, Cc, and Bcc headers.

              --format-version=N

                  Use the specified structured output format version.  This is intended for programs that invoke
                  notmuch(1) internally.  If omitted, the latest supported version will be used.

              --reply-to=(all|sender)

                  all (default)
                      Replies to all addresses.

                  sender
                      Replies  only  to the sender. If replying to user's own message (Reply-to: or From: header
                      is one of the user's configured email addresses), try To:, Cc:, and Bcc: headers  in  this
                      order,  and  copy values from the first that contains something other than only the user's
                      addresses.

              --decrypt

                  Decrypt any MIME encrypted parts found in  the  selected  content  (ie.  "multipart/encrypted"
                  parts). Status of the decryption will be reported (currently only supported with --format=json
                  and --format=sexp) and on successful decryption the multipart/encrypted part will be  replaced
                  by the decrypted content.

                  Decryption  expects a functioning gpg-agent(1) to provide any needed credentials. Without one,
                  the decryption will fail.

       See notmuch-search-terms(7) for details of the supported syntax for <search-terms>.

       Note: It is most common to use notmuch reply with a search string matching a  single  message,  (such  as
       id:<message-id>),  but  it can be useful to reply to several messages at once. For example, when a series
       of patches are sent in a single thread, replying to the entire thread allows for the reply to comment  on
       issues  found in multiple patches. The default format supports replying to multiple messages at once, but
       the JSON and S-Expression formats do not.

EXIT STATUS

       This command supports the following special exit status codes

       20     The requested format version is too old.

       21     The requested format version is too new.

SEE ALSO

       notmuch(1), notmuch-config(1), notmuch-count(1),  notmuch-dump(1),  notmuch-hooks(5),  notmuch-insert(1),
       notmuch-new(1), notmuch-restore(1), notmuch-search(1), notmuch-search-terms(7), notmuch-show(1), notmuch-
       tag(1)