feat(gmail): add autoreply command

Author: steipete

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## Unreleased
+
+### Added
+- Gmail: add `gmail autoreply` to reply once to matching messages, label the thread for dedupe, and optionally archive/mark read. Includes docs and regression coverage for skip/reply flows.
+
 ## 0.12.0 - 2026-03-09
 
 ### Highlights

docs/gmail-autoreply.md

@@ -0,0 +1,43 @@
+---
+summary: "Reply once to matching Gmail messages with gog"
+read_when:
+  - Adding Gmail email automation
+  - Setting up mailbox auto-replies without Gmail templates
+---
+
+# Gmail auto-reply
+
+`gog gmail autoreply` is a one-shot command.
+
+Use it on a schedule with `launchd`, cron, or another runner when Gmail's native filter API is not enough.
+
+## Example
+
+Reply once to mail sent to `security@openclaw.ai`, add a dedupe label, then archive:
+
+```bash
+gog -a clawdbot@gmail.com gmail autoreply \
+  'to:security@openclaw.ai in:inbox -label:SecurityAutoReplied' \
+  --body-file ./security-autoreply.txt \
+  --label SecurityAutoReplied \
+  --archive \
+  --mark-read
+```
+
+Recommended reply text:
+
+```text
+Thanks for contacting OpenClaw Security.
+
+For fastest triage, please submit security reports privately via GitHub:
+https://github.com/openclaw/openclaw/security/advisories/new
+
+If you cannot use GitHub or are unsure which repo is affected, reply to this email.
+```
+
+## Notes
+
+- The command is idempotent per thread via the post-reply label.
+- It sends replies in-thread with `In-Reply-To` and `References`.
+- It adds `Auto-Submitted: auto-replied` and suppresses common auto-response loops.
+- By default it skips bulk/list/auto-generated mail.

internal/cmd/gmail.go

@@ -20,9 +20,10 @@ type GmailCmd struct {
 	Unread  GmailUnreadCmd   `cmd:"" name:"unread" aliases:"mark-unread" group:"Organize" help:"Mark messages as unread"`
 	Trash   GmailTrashMsgCmd `cmd:"" name:"trash" group:"Organize" help:"Move messages to trash"`
 
-	Send   GmailSendCmd   `cmd:"" name:"send" group:"Write" help:"Send an email"`
-	Track  GmailTrackCmd  `cmd:"" name:"track" group:"Write" help:"Email open tracking"`
-	Drafts GmailDraftsCmd `cmd:"" name:"drafts" aliases:"draft" group:"Write" help:"Draft operations"`
+	Send      GmailSendCmd      `cmd:"" name:"send" group:"Write" help:"Send an email"`
+	AutoReply GmailAutoReplyCmd `cmd:"" name:"autoreply" group:"Write" help:"Reply once to matching messages"`
+	Track     GmailTrackCmd     `cmd:"" name:"track" group:"Write" help:"Email open tracking"`
+	Drafts    GmailDraftsCmd    `cmd:"" name:"drafts" aliases:"draft" group:"Write" help:"Draft operations"`
 
 	Settings GmailSettingsCmd `cmd:"" name:"settings" group:"Admin" help:"Settings and admin"`