Skip to main content

Usage

First Launch​

On first launch, Matcha will prompt you to configure an email account. You'll need:

  • Your email address
  • Your password (or app-specific password for Gmail/iCloud)
  • Email provider (Gmail, iCloud, or Custom)

Keyboard Shortcuts​

  • ↑/↓ or j/k - Navigate menu items
  • Enter - Select option
  • Esc - Go back / Exit
  • Ctrl+C - Quit application

Inbox View​

  • ↑/↓ or j/k - Navigate emails
  • ←/→ or h/l - Switch between account tabs
  • Enter - Open selected email
  • / - Filter/search emails
  • r - Refresh inbox
  • d - Delete selected email
  • a - Archive selected email
  • Esc - Back to main menu

Email View​

  • ↑/↓ or j/k - Scroll email content
  • r - Reply to email
  • d - Delete email
  • a - Archive email
  • Tab - Focus attachments
  • Esc - Back to inbox
  • i - Toggle images

Attachment View (when focused)​

  • ↑/↓ or j/k - Navigate attachments
  • Enter - Download and open attachment
  • Tab or Esc - Back to email body

Composer​

  • Tab / Shift+Tab - Navigate fields
  • Enter -
    • On "From" field: Select account (if multiple)
    • On "Attachment" field: Open file picker
    • On "Send" button: Send email
  • ↑/↓ - Navigate contact suggestions (when typing in "To" field)
  • Esc - Save draft and exit

Updating Matcha​

Check for updates and install the latest version:

matcha update

This command will:

  1. Check for the latest release on GitHub
  2. Detect your installation method (Homebrew, Snap, or binary)
  3. Update using the appropriate method