1---
2name: gws-gmail-triage
3description: "Gmail: Show unread inbox summary (sender, subject, date)."
4metadata:
5  version: 0.22.5
6  openclaw:
7    category: "productivity"
8    requires:
9      bins:
10        - gws
11    cliHelp: "gws gmail +triage --help"
12---
13 
14# gmail +triage
15 
16> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
17 
18Show unread inbox summary (sender, subject, date)
19 
20## Usage
21 
22```bash
23gws gmail +triage
24```
25 
26## Flags
27 
28| Flag | Required | Default | Description |
29|------|----------|---------|-------------|
30| `--max` | — | 20 | Maximum messages to show (default: 20) |
31| `--query` | — | — | Gmail search query (default: is:unread) |
32| `--labels` | — | — | Include label names in output |
33 
34## Examples
35 
36```bash
37gws gmail +triage
38gws gmail +triage --max 5 --query 'from:boss'
39gws gmail +triage --format json | jq '.[].subject'
40gws gmail +triage --labels
41```
42 
43## Tips
44 
45- Read-only — never modifies your mailbox.
46- Defaults to table output format.
47 
48## See Also
49 
50- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
51- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
52