skills.rest
oresttokovenko
oresttokovenkoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gws-gmail-triage

Displays unread Gmail inbox summary with sender, subject, and date.

Updated Nov 9, 2023
Search Tags:#productivity#gmail#terminal#json output#email triage#gws cli#unread inbox
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-triage-oresttokovenko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-triage
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-gmail-triage
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-triage-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually opening Gmail to scan for unread messages interrupts focused work. This Skill surfaces a concise unread inbox summary directly in the terminal so you can triage email without leaving your workflow. ## Core Features & Use Cases - Unread Inbox Summary: Lists unread messages with sender, subject, and date in a table format. - Custom Queries and Limits: Filter with Gmail search syntax (e.g., from:boss) and cap results with --max. - Structured Output: Export results as JSON for piping into tools like jq, and optionally include label names. - Use Case: Run a quick morning check with a filtered query to see only unread messages from your manager before deciding what needs an immediate reply. ## Quick Start Ask the assistant to show a summary of your unread Gmail inbox, optionally filtered by sender or limited to a specific number of 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 check unread Gmail messages from the command line?▼

Run gws gmail +triage to list unread messages with sender, subject, and date in a table. Use --max to limit results and --query to apply Gmail search filters like from:boss.

How to filter Gmail unread messages by sender in terminal?▼

Pass a Gmail search query with the --query flag, for example gws gmail +triage --query 'from:boss'. Any standard Gmail search syntax works, and the default query is is:unread.

Can I get Gmail triage output as JSON for scripting?▼

Yes, add --format json to output structured data that pipes cleanly into tools like jq. For example, gws gmail +triage --format json | jq '.[].subject' extracts just the subject lines.

Does the Gmail triage command modify my mailbox?▼

No, the command is read-only and never modifies your mailbox. It only fetches and displays message metadata such as sender, subject, date, and optionally labels.

Why does gws gmail +triage fail with an auth error?▼

The command requires the gws CLI to be installed and authenticated with Gmail access. Check the gws-shared skill documentation for authentication setup and global flags before running triage.

Related Skills

Explore More Personal & Entrepreneur Skills→
cellarwoodcellarwood

gws-gmail

Manage Gmail messages and mailboxes via the gws command-line interface.

Official
Intermediate
73ai73ai
4

gws-gmail

Automate Gmail sending, reading, and managing from the command line.

Official
Intermediate
cellarwoodcellarwood

gws-workflow-weekly-digest

Summarize weekly Google Workspace meetings and unread Gmail counts into configurable formats.

Official
Intermediate
davpatel605-beepdavpatel605-beep

himalaya

Manage terminal-based email operations via IMAP and SMTP using the Himalaya CLI.

Community
Intermediate