bygoogleworkspace· 58 skills
Gmail: Show unread inbox summary (sender, subject, date).
$npx -y skills add googleworkspace/cli --skill gws-gmail-triageInstalls into the current project.
Run `npx skills use "https://github.com/googleworkspace/cli" --skill "googleworkspace/cli/gws-gmail-triage"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/googleworkspace/cli" that are relevant to the current task. Run `npx skills add "https://github.com/googleworkspace/cli"` and select the relevant skills, then follow their instructions.
| 1 | # gmail +triage |
| 2 | |
| 3 | > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. |
| 4 | |
| 5 | Show unread inbox summary (sender, subject, date) |
| 6 | |
| 7 | ## Usage |
| 8 | |
| 9 | ```bash |
| 10 | gws gmail +triage |
| 11 | ``` |
| 12 | |
| 13 | ## Flags |
| 14 | |
| 15 | | Flag | Required | Default | Description | |
| 16 | |------|----------|---------|-------------| |
| 17 | | `--max` | — | 20 | Maximum messages to show (default: 20) | |
| 18 | | `--query` | — | — | Gmail search query (default: is:unread) | |
| 19 | | `--labels` | — | — | Include label names in output | |
| 20 | |
| 21 | ## Examples |
| 22 | |
| 23 | ```bash |
| 24 | gws gmail +triage |
| 25 | gws gmail +triage --max 5 --query 'from:boss' |
| 26 | gws gmail +triage --format json | jq '.[].subject' |
| 27 | gws gmail +triage --labels |
| 28 | ``` |
| 29 | |
| 30 | ## Tips |
| 31 | |
| 32 | - Read-only — never modifies your mailbox. |
| 33 | - Defaults to table output format. |
| 34 | |
| 35 | ## See Also |
| 36 | |
| 37 | - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth |
| 38 | - [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands |