2.7.0

Added

• sender= CLI filter argument for filtering by the actual sender via the Return-Path header
  • The Return-Path (envelope sender) may differ from the From header when the sending address is not the author address
  • Works with --filter, --filter:bool, -a, --move, --count, --index, and --match
  • Partial match, case-insensitive (same behavior as from=)
• sender property in task FILTER_CONFIG for filtering by Return-Path header in verbose task and custom tasks
• IMAP fetch now requests the RETURN-PATH header field alongside FROM, TO, SUBJECT, and DATE
• Test suite for sender= filter argument with 13 new tests

2.6.0

Added

• --stop option to halt processing after the first matching email is found
• --count option to output the total number of matching emails without processing them
• --match option to filter emails by a pattern and output only those that match
• --index option to target a specific email by its index position
• New helpers/emailChain.mjs helper for parsing and working with email chain/thread data
• Helper variable support in extractEmailTasks/verbose.js.template for use in task configuration

Changed

• Improved helpers/narrowRequestedData.js and helpers/filterHelper.mjs for more accurate narrowing and filtering of email data

2.5.0

Added

• --check option to inspect emails and report matches without downloading or processing
  • Outputs a summary of matching emails (number, from, subject, date)
  • Non-destructive — no emails are moved, downloaded, or modified
• --range <start-end> option to process a specific range of emails by number
  • Accepts start and end as inclusive bounds (e.g., --range 5-15)
  • Works in combination with other flags such as -a, --task, and --filter
• --move <folder> option to move processed emails to a specified IMAP folder after processing
  • Supports any valid IMAP folder path (e.g., Processed, Archive/2026)
  • Can be combined with --task and -a for post-processing organization

Changed

• Added a doing-work indicator during long-running operations to provide visual feedback that processing is active
• Email processing operations now run as background processes to prevent blocking when handling large mailboxes
• Default behaviour no longer includes the Sent folder when searching or listing emails
  • Previously all IMAP folders including Sent were included by default
  • Use an explicit folder argument to include Sent when needed