gws-gmail-triage
Installation
Summary
Quickly summarize unread Gmail inbox messages with sender, subject, and date.
- Displays up to 20 unread messages by default; customize with
--maxflag - Supports Gmail search queries via
--queryflag to filter beyond unread (e.g.,from:boss) - Read-only operation; never modifies your mailbox
- Optional
--labelsflag includes label names in output; supports JSON format for scripting
SKILL.md
gmail +triage
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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 |
Examples
gws gmail +triage
gws gmail +triage --max 5 --query 'from:boss'
gws gmail +triage --format json | jq '.[].subject'
gws gmail +triage --labels
Tips
- Read-only — never modifies your mailbox.
- Defaults to table output format.
See Also
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands