Download
RU EN DE FR ES PT 中文

Email Client — User Guide | YoBench

How to use the Email module in YoBench: IMAP/SMTP and EWS (Exchange/O365), multiple accounts, OAuth, folders, search, bulk actions.

What the Email module does

The module is YoBench's built-in email client, combining IMAP/SMTP and EWS (Exchange / Office 365) in one interface. Multiple accounts, folders, search, bulk actions and background sync — without keeping a separate Mail.app, Outlook or browser tab open.

What you get:

  • IMAP/SMTP for Gmail, Yandex, your own servers — full MIME via ImapFlow + nodemailer.
  • EWS for Exchange and Office 365 — structured data via ews-javascript-api, lazy-loaded attachments.
  • Rich-text composer — formatting, links, lists, inline images and signatures, with attachments via drag-and-drop.
  • Drafts — saved automatically while you compose. Pick up where you left off from any device that hosts the same account.
  • Undo send — a configurable grace window in which a sent message can be cancelled before it leaves the outbox.
  • Contacts autocomplete — to / cc / bcc suggestions from your sent / received history.
  • AI summarize and smart-reply — one-click summary of a long thread and AI-drafted reply suggestions, powered by your AI provider.
  • Dock badge for unread — total unread count on the application icon (macOS dock / Windows taskbar).
  • Multiple concurrent accounts — each with its own per-folder sync state.
  • Folders with special_use metadata, unread counters and uid_validity.
  • Search — by subject, from and preview via LIKE in the database.
  • Bulk actions — mark read/unread, toggle flag, move to folder, delete — across an arbitrary message set.
  • Attachments — metadata in the DB, content on disk; for EWS, fetched on demand.
  • Background worker — email-sync-worker with its own WAL DB connection, 30-minute timeout and auto-restart on crash.
  • Encryption — passwords and OAuth tokens are stored encrypted.

Account parameters

When creating an account you set:

  • Name and email — shown in the account list.
  • Username and Password — credentials.
  • Protocol — imap (default) or ews.
  • Color — visual identifier in the UI.

IMAP parameters

  • IMAP host / port — incoming.
  • SMTP host / port — outgoing.
  • Use TLS — encryption flag.

EWS parameters

  • EWS URL — Exchange service URL.
  • Domain — Active Directory domain (optional).
  • Auth type — password or oauth2.
  • OAuth provider — outlook or google.
  • OAuth tokens — access/refresh, refreshed automatically.

Passwords and tokens are encrypted before being written to the database.

Global settings

Under Settings → Email:

  • Enable email (emailEnabled) — module master switch.
  • Sync interval (minutes) (emailPollMinutes) — default 15.
  • Concurrency (emailSyncConcurrency) — how many accounts are polled in parallel (default 3).

UI features

  • Account sidebar — list of accounts with color tags and unread counters.
  • Folder list — special labels (special_use: Inbox, Sent, Drafts, Trash, Junk, Archive).
  • Message list — subject, from, preview, date, is_read, is_flagged, is_answered flags. Threads grouped by thread_id.
  • Message viewer — HTML render, attachment list, Reply / Reply All / Forward / Delete actions.
  • Composer — to / cc / bcc fields, subject, attachments, signature.

Sending

  • IMAP accounts — outbound via nodemailer SMTP.
  • EWS accounts — built-in SendMail API.
  • In both cases the outgoing message is auto-saved to the Sent folder (with empty provider_id to mark local origin).

Rich-text composer

The composer supports headings, bold / italic, lists, links, inline images and signatures. Drag a file into the editor to attach it; paste an image from the clipboard to inline it. Switching between rich-text and plain-text is one toggle.

Drafts and undo send

Every composer auto-saves a draft as you type. The Drafts folder lists every unfinished message — click to resume editing. When you send, the message is held in a local outbox for the configured Undo send window (default 5 seconds); clicking Undo during that window restores the composer with all attachments and recipients intact.

Contacts autocomplete

Start typing in to / cc / bcc and a dropdown suggests addresses from messages you have sent or received. Recently used addresses bubble to the top.

AI summarize and smart-reply

In the message viewer a long thread shows an AI summary button: one click and the AI provider returns a concise digest with the key questions and decisions. Smart-reply generates two or three reply drafts (acknowledge / commit / decline) for you to pick from — each draft lands in the composer where you can edit and send.

Both features use the AI Chat provider. If no provider is configured the buttons are disabled.

Workflow

1. Connect an account

  1. Open the Email module from the left sidebar.
  2. Click Add account.
  3. Pick the protocol (IMAP or EWS).
  4. Fill in the parameters.
  5. For EWS with OAuth — complete the OAuth flow (Outlook / Google).
  6. Save. The first sync starts automatically.

2. Turn on auto-sync

In settings flip Enable email, set the interval and concurrency. The worker starts polling accounts in the background.

3. Work with mail

  • Read messages — click a row to open the viewer.
  • Reply or forward via the message toolbar.
  • Flag or mark as read.
  • Move to folders or delete.
  • Search — by subject, sender or preview.

4. Bulk actions

Select multiple messages with checkboxes → pick an action in the list header (mark read / unread / flag / move / delete). Actions apply both to the local DB and the server.

5. Manage accounts

  • Edit — change credentials or OAuth tokens.
  • Sync now — force-poll an account.
  • Delete — removes the account and its local message copy.

Next steps

  • Wire up the Calendar to show meetings from Exchange accounts.
  • Use AI Chat with a RAG context to draft templated replies.
  • Notifications use YoBench's shared channels (Telegram, outgoing email).

Help and feedback

Want PGP, S/MIME, or custom auto-filtering rules? Contact us via the feedback form.