gmail +watch

PREREQUISITE: Read

../gws-shared/SKILL.md

for auth, global flags, and security rules. If missing, run

gws generate-skills

to create it.

Usage

gws gmail +watch

Flags

--project

--subscription

--topic

--label-ids

--max-messages

--poll-interval

--msg-format

--once

--cleanup

--output-dir

Examples

gws gmail +watch --project my-gcp-project
gws gmail +watch --project my-project --label-ids INBOX --once
gws gmail +watch --subscription projects/p/subscriptions/my-sub
gws gmail +watch --project my-project --cleanup --output-dir ./emails

Tips

• Gmail watch expires after 7 days — re-run to renew.
• Without --cleanup, Pub/Sub resources persist for reconnection.
• Press Ctrl-C to stop gracefully.

See Also

• gws-shared — Global flags and auth
• gws-gmail — All send, read, and manage email commands