maildir-varlink CLAUDE

Project Overview

Varlink service that exposes maildir email operations using mblaze tools.

mblaze Tools Integration

This project wraps the mblaze suite of maildir utilities. CRITICAL: These tools have specific behavior that must be understood before use.

ALWAYS Read Manpages First

Before implementing or modifying any functionality that uses mblaze tools, ALWAYS read the manpage:

man mscan    # Message summaries
man mshow    # Show message content
man mlist    # List messages in mailbox
man mpick    # Search with expression language
man magrep   # Search by header/body pattern
man mdirs    # List maildir folders

Common Pitfalls

mscan - Message Summaries

WRONG: mscan -n for summaries

• The -n flag means "numbers/filenames only", NOT "no pager"
• This will output just the message path, not a summary

RIGHT: Use format strings

mscan -f "%10d %17f %s"  # date, from, subject

Pager control: Set MBLAZE_PAGER=cat environment variable to disable paging