gws-gmail-triage

List unread Gmail messages with sender, subject, and date.

2|1|Updated Oct 8, 2009
One-click install
npx skills add https://github.com/riethmayer/dotfiles --skill gws-gmail-triage-riethmayer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-triage
Source: https://github.com/riethmayer/dotfiles/tree/main/stow/agents/.agents/skills/gws-gmail-triage
Command: npx skills add https://github.com/riethmayer/dotfiles --skill gws-gmail-triage-riethmayer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Show unread Gmail messages with sender, subject, and date, enabling a quick inbox triage.

Core Features & Use Cases

  • Unread inbox snapshot: List unread messages with sender, subject, and date.
  • Filter and limit: Respect --max, --query, and optional --labels to refine results.
  • Usage in workflows: Ideal for daily standups, email triage, and quick status checks within a CI-like workflow.

Quick Start

Run gws gmail +triage to display your unread messages.

Frequently Asked Questions about gws-gmail-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a quick unread Gmail inbox summary for daily triage?▼

You can triage unread Gmail messages by running a command that lists sender, subject, and date. This read-only overview enables rapid scanning of your inbox without opening individual emails.

How do I filter unread Gmail messages by label or search query?▼

Filter unread Gmail messages by applying flags like --max, --query, and --labels to refine results. These parameters limit the output to specific labels or search terms.

Can I use this Gmail triage tool in a CI-like workflow or daily standup?▼

Yes, this Gmail triage tool is designed for CI-like workflows and daily standups. It provides a quick status check of unread messages directly from the command line.

Does this Gmail inbox snapshot support sending or deleting emails?▼

No, this Gmail inbox snapshot is strictly read-only by design. It displays unread messages with sender, subject, and date but does not support sending or deleting emails.

What authentication do I need to list unread Gmail messages via CLI?▼

Listing unread Gmail messages via CLI relies on the gws shared auth flow. This prerequisite authentication mechanism securely connects the command line interface to your Gmail account.