Pending mail
mail_pendingIdentify threads requiring action: mail you need to reply to, or mail you are waiting on. Filter by age and scope.
Instructions
Threads that need attention: mail owed by you, or mail you are waiting on.
direction='owed': threads matching scope that no message has ever
been tagged 'replied' on, i.e. mail you have not answered. Use this
for "what do I still need to reply to".
direction='waiting': threads where your own address sent the most recent message and nobody has responded since. Use this for "who owes ME a reply". Needs at least one address configured under [identity] addresses in the config (normally defaulted automatically from notmuch's own user.primary_email/user.other_email); without that, this direction raises an actionable error rather than guessing.
Both directions sort oldest (most overdue) first, since age is the point. This is not a substitute for mail_search when you want to see the messages themselves, only for triaging what is outstanding.
Args: direction: 'owed' (you have not replied) or 'waiting' (you are waiting on a reply). older_than: Only include threads whose relevant date is at least this old, e.g. '14d', '2w', '3m', '1y'. Omit for no age floor. scope: Name of a configured scope to restrict the search (see mail_list_scopes). Defaults to the configured default scope. limit: Maximum number of threads to return.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| scope | No | ||
| direction | No | owed | |
| older_than | No |