emaillisted

# Email Reach for the lightest tool that does the job. Walk the tool ladder below top to bottom, trying each tier first and falling through to the next ONLY on tool absence OR auth failure. ## Repo Context Probe If `.claude/skill-context/email.md` exists, read it and honor its declarations; otherwise use the generic defaults described below. The context file is where a repo declares a faster project-local mail CLI (e.g. a Redis-cached mail CLI) to try as **Tier 1**, above the generic ladder. When the file is absent (the common case in a foreign repo), start the ladder at Tier 2 (`gws gmail`) — the generic tiers below need nothing beyond a Google Workspace login or an interactive MCP session. ## Tool Ladder (priority order) ### Tier 1 — project mail CLI (only if the context file declares one) If the context file declares a fast project email CLI, try it first for both read and send. Fall through to Tier 2 if it is not on PATH, or a read/send fails because its backing service is unreachable. If no context file is present, skip this tier entirely. ### Tier 2 — `gws gmail` (Google Workspace CLI, direct API) Google's official Workspace CLI. On PATH after `npm install -g @googleworkspace/cli`. Requires a one-time human `gws auth setup` / `gws auth login` OAuth step — if a call fails with an auth error, fall through. ```bash gws gmail users messages list --params '{"userId": "me", "maxResults": 5}' gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}' ``