Docs/ Rules, context & knowledge

Inbox rules

Filters that fire on arrival — by keyword or by AI-understood concept.

Inbox rules run server-side the moment a message syncs, so your inbox is always organised before you open the app.

How rules work

Every incoming message is evaluated against your active rules in priority order. When a rule matches, its actions run immediately — labelling, archiving, starring, marking as read, or moving to spam. Each action is written to the audit log and can be reversed from the activity feed.

You can match on concrete attributes (sender address, subject text, keywords, attachment presence) or on AI-understood concepts. AI conditions let you describe intent rather than keywords — the model reads the message and decides whether it fits.

Server-side execution

Rules fire during sync, before the message reaches your device. Even if you're offline, every rule has already run by the time you open the app.

Match conditions

You can combine any number of conditions in a single rule (all-match or any-match). The following condition types are available:

Condition typeWhat it matches onExample value
SenderFrom address or domainupdates@example.com, @github.com
SubjectSubject line contains"invoice", "follow-up"
KeywordBody or subject contains"Q3 report"
Has attachmentAttachment present / absenttrue
AI conceptAgent reads and classifies intent"this is an investor update"

Creating a rule

There are three paths to a new rule. All three produce the same rule object — pick whichever feels fastest.

  1. 1

    Start from a template

    Open Rules → New rule → Browse templates. Choose from 15 ready-made rules (newsletter archiver, receipt labeller, PR review router, and more). Activate with one click; customise conditions and actions afterward.

  2. 2

    Build with the form

    Tap 'Custom rule', add conditions one by one, and pick actions from the dropdown. The live match-count preview updates in real time, showing how many messages in your existing inbox would have matched — so you know the rule isn't too broad or too narrow before saving.

  3. 3

    Describe it in plain English

    Type what you want in the natural-language box and the AI assembles the rule for you. Review the generated conditions and actions, adjust if needed, then save.

Plain-English rule → generated rule
You typedArchive all investor updates and label them Fundraising
─────────────────────────────────
AI conceptthis is an investor update
ActionsLabel: Fundraising
Archive

Available actions

A rule can apply one or more actions to a matched message. Actions are non-destructive: each one is logged and reversible from the activity feed.

  • Label — attach one or more labels (created automatically if they don't exist yet)
  • Archive — remove from inbox without deleting
  • Star — add to your starred / priority view
  • Mark as read — suppress the unread badge
  • Move to spam — route to spam folder

Audit and undo

Every rule action is written to the activity feed with a timestamp, the rule that triggered it, and the message subject. You can undo any single action or roll back an entire rule's history for a selected time window.

Disabling a rule stops future actions but does not undo past ones. You can re-enable, edit, or delete a rule at any time.

Test before you enable

Use the live match-count preview to see how many existing messages would match your rule. A count in the hundreds is a signal to tighten your conditions.

Frequently asked

Feature overview

Rules & Brain

Ready to try it?

Start free