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.