Triage mail into clean labels
Understands sender and intent, then applies a predictable label taxonomy.
GMAIL · TASKS · CALENDAR
GWS for Dummies lets you tell an AI coding agent what you want in plain English. It uses the Google Workspace CLI to label mail, create Tasks and Calendar events, and prepare useful recaps without sending, trashing, or deleting anything.
Open any supported agent and paste the instruction below. It will read the setup guide and walk you through installing the CLI, connecting your Google account, and running your first inbox triage.
set up gws for dummies — https://gws-for-dummies.vercel.app/llms.txt
Prefer the terminal? Run the setup script yourself. On Windows, use Git Bash or WSL.
git clone https://github.com/Mulla759/GWSforDummies.git && cd GWSforDummies && ./setup.sh
$ gws-do "triage my inbox"
› routed to email-triage-orchestrator
· scanned 24 messages
· flagged 3 (security)
· labeled 21
Finance 6
Newsletters 9
Security 3
Priority 3
✓ nothing sent, trashed, or deleted
Understands sender and intent, then applies a predictable label taxonomy.
Creates traceable Tasks and Calendar events with source links and undo notes.
Produces a read-only summary of meetings, unread mail, and triage activity.
Runs deterministic, idempotent sender-to-label rules locally or in GitHub Actions.
Set up in three steps.
Install the Google Workspace CLI and clone the project.
npm install -g @googleworkspace/cli
git clone https://github.com/Mulla759/GWSforDummies.git && cd GWSforDummies
Sign in to your own Google account. The runbook covers creating the OAuth client first.
gws auth login -s "gmail,tasks,calendar"
The agent runbook walks through creating a free Google Cloud project, enabling the Gmail, Calendar, and Tasks APIs, and placing client_secret.json. Open the full runbook
Describe what you want in plain English.
gws-do "triage my inbox"
Reads and labels. Never sends, trashes, or deletes.
Student · Computer scientist
Have a setup issue, an improvement, or a workflow worth adding? I’d like to hear about it.