Skip to content

Automated follow-ups

Email follow-up is a memory tax. mxr’s automated follow-ups remove it:

  • Send a message and configure a reminder: if no reply lands by the given time, mxr surfaces it back to you.
  • Schedule a draft for a future send time: write now, deliver later.

Both run as 60-second daemon background loops. Reminder schedules resume after restarts; send attempts retain their outcome so an interrupted delivery is not silently retried.

Set on outbound messages. Stored in the auto_reminders table; fired by the auto_reminders_loop.

Terminal window
# After sending, add a follow-up reminder:
mxr remind MESSAGE_ID --when "in 5d"
mxr remind MESSAGE_ID --when "monday 9am"
# Send a reply and set the follow-up in one step:
mxr reply MESSAGE_ID --body "Thanks, I'll check." --yes --remind-after "in 5d"
# Cancel before it fires:
mxr remind MESSAGE_ID --cancel

In the TUI compose confirmation, press n, enter the same relative time string, and press Enter to send and set the reminder in one flow. Use the palette (:) → Cancel no-reply reminder from the focused sent message to cancel a pending reminder.

The one-shot reply --yes prints its send operation ID and recovery query to stderr before submission. If the response is lost, query that operation instead of rerunning the reply command; a rerun creates another draft.

A reply from a person cancels the reminder: any message from someone else stored in the conversation after yours, or one whose In-Reply-To names your message wherever it was filed. An auto-responder or notification does not count. Storage order decides, not the Date header. The check runs when the reminder is due, and a reply that arrives while it runs stops the reminder from firing until it is checked.

While the reminder is pending, the conversation stays off the desk’s Waiting on. When the time elapses, mxr marks the sent message for reply-later, refreshes is:reply-later search state, puts the conversation back on Waiting on, and emits one ReminderTriggered event so connected clients can surface the follow-up. It fires once, even if the daemon was stopped at the time and started later. Re-setting the reminder on the same message replaces the existing schedule. mxr desk later THREAD_ID --at TIME sets the same reminder on a conversation you wrote last, with a dry run and undo (come back to it later).

Schedule a draft for a future send time. The daemon’s flusher loop picks up due drafts and runs them through the same send_stored_draft pipeline that interactive sends use, so the message arrives at the provider exactly as it would have if you’d sent it manually then.

Terminal window
# Compose a draft (any usual flow), then schedule it:
mxr send DRAFT_ID --dry-run --format json
mxr send DRAFT_ID --at "tomorrow 9am" \
--expected-revision REVISION_FROM_PREVIEW \
--expected-workspace '<OWNER_JSON_FROM_PREVIEW>'
# Cancel a scheduled send:
mxr unsend DRAFT_ID

Scheduling checks the account first. An account that cannot send, such as a receive-only IMAP account with no SMTP side, is refused right away with No send provider configured for account <id>, so you never wait for a send that cannot go out.

The scheduler assigns a separate operation identity. If delivery is interrupted, query the scheduled draft with the exact expected_workspace JSON from its schedule preview. Shell-quote that JSON and do not recapture it from the current daemon:

Terminal window
mxr send-outcome 'draft:DRAFT_ID' --account ACCOUNT_ID \
--expected-workspace '<OWNER_JSON_FROM_SCHEDULE_PREVIEW>' --format json

The ordinary send preview’s operation ID does not identify a scheduled attempt. The global last-send query can still refer to a different draft; use the draft alias for this schedule. If you cancel before the scheduled attempt starts, the draft stays available to edit and review again. After an attempt has started, query its outcome before scheduling again.

The flusher clears the send_at flag on a draft before invoking the send, and sends only the revision reviewed when you scheduled it. A later edit does not silently replace that message. If an attempt’s result is uncertain, query its outcome using the draft alias above and do not schedule another send unless the outcome is explicitly not_accepted. The scheduler does not make an uncertain send safe by retrying it after restart.

mxr unsend and Undo in Raycast, Cancel send in the web app and c in the TUI draft browser all cancel the same thing. When the daemon’s flusher reaches the draft, it claims the send in one step, only if the draft is due and its send time is unchanged. Your cancel makes the same check, so exactly one of them wins:

  • If your cancel wins, nothing is sent and the draft stays.
  • If the flusher wins, the send goes out and the cancel fails with Too late to stop it: this send has already started, or it was not scheduled. Check mxr send-outcome to see what happened.
  • If you move the send time while the flusher is looking at the draft, the send waits for the new time.

Both mxr remind --when and mxr send --at accept the same time phrases as mxr snooze --until, resolved in local time:

  • Relative durations: in 30m, in 2h, in 5d, in 2w, 3d
  • Named days: tomorrow, monday, tue, next week, 3 oct
  • Day + time: tomorrow 9am, monday 17:00, fri 3
  • Today: today 17:00 (must be a future time)
  • RFC3339: 2026-06-01T15:00:00Z

Past times are rejected. “Today” without a specific time is rejected (too ambiguous). Preview any phrase with mxr time "<phrase>".

  • The reminder + send-later loops run every 60 seconds. The minimum practical scheduling resolution is therefore 60s; finer-grained scheduling would require ticker tuning.
  • Both loops are crash-safe by virtue of the underlying state being in SQLite: restarting the daemon picks up where it left off.
  • A cancelled reminder keeps its row with cancelled_at set. A cancelled send (mxr unsend) only clears the draft’s send time; the draft stays.

If a reminder fires on an outbound message that’s still awaiting a reply, mxr flags the original outbound for reply-later so it shows up in mxr replies alongside the rest of your follow-up queue:

Terminal window
mxr replies --format json

What you get: the same reply-later queue, now including due auto-reminders.