gws-gmail-triage

Quickly summarize unread Gmail inbox messages with sender, subject, and date.

- Displays up to 20 unread messages by default; customize with --max flag

- Supports Gmail search queries via --query flag to filter beyond unread (e.g., from:boss)

- Read-only operation; never modifies your mailbox

- Optional --labels flag includes label names in output; supports JSON format for scripting

gmail +triage

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Show unread inbox summary (sender, subject, date)

Usage

gws gmail +triage

Flags

Flag
Required
Default
Description

--max
-
20
Maximum messages to show (default: 20)

--query
-
-
Gmail search query (default: is:unread)

--labels
-
-
Include label names in output