dotfiles/aerc/.config/aerc/AGENTS.md

Agent Guidelines: Aerc Configuration Repository

This repository contains the configuration and customization for aerc, a terminal-based email client. It is optimized for a workflow involving notmuch for indexing, mbsync for synchronization, and abook for address management.

1. Build, Lint, and Test Commands

Sync and Maintenance

• Global Sync: Run mailsync (bound to u in aerc) to perform:
  1. mbsync -a (Mail synchronization)
  2. notmuch new for all account databases (Indexing)
  3. notmuch-abook-sync (Address book population)
• Manual Sync: Run individual commands if needed for specific accounts: NOTMUCH_CONFIG=~/Mail/phil/.notmuch-config notmuch new

Linting

• Permissions: accounts.conf must be 0600.
• Dependencies: w3m, bat, yazi, notmuch, abook, pass, isync.

Testing

• Filters:

  cat email.html | w3m -T text/html -dump
  

• Address Book Query:

  abook --mutt-query "search term"
  

2. Code Style Guidelines

Aerc Configuration

• Notmuch URI: Use the absolute triple-slash format: source = notmuch:///home/liph/Mail/account_name.
• Credentials: Use pass via outgoing-cred-cmd = pass show mail/account_email.
• Sidebar: Use separate notmuch databases per account directory for isolation.

Keybindings

• Leader: , (comma).
• Contacts: ,ab opens abook in a terminal.
• Picker: yazi is the default for attachments (file-picker-cmd).

Neovim integration (after/ftplugin/mail.lua)

• Completion: Triggered by Tab on header lines using abook --mutt-query.
• Fzf: Triggered by Ctrl+f for interactive contact selection.