SkillsAdd

finpeakinc/gws-cli · Archived

gws-gmail-watch

Gmail: Watch for new emails and stream them as NDJSON.

First seen Jun 25, 2026

Installation

$ npx skills add finpeakinc/gws-cli --skill gws-gmail-watch
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

gws-shared Same source · more installs
finpeakinc/gws-cli

gws CLI: Shared patterns for authentication, global flags, and output formatting.

22 installs
gws-gmail Same source · more installs
finpeakinc/gws-cli

Gmail: Send, read, and manage email.

19 installs
gws-gmail-read Same source
finpeakinc/gws-cli

Gmail: Read a message and extract its body or headers.

18 installs
gws-gmail-triage Same source
finpeakinc/gws-cli

Gmail: Show unread inbox summary (sender, subject, date).

18 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

gws-gmail Similar name
googleworkspace/cli

Gmail: Send, read, and manage email.

74.7K installs
gws-gmail-send Similar name
googleworkspace/cli

Gmail: Send an email.

69.5K installs
gws-gmail-triage Similar name
googleworkspace/cli

Gmail: Show unread inbox summary (sender, subject, date).

41.4K installs
gws-gmail-read Similar name
googleworkspace/cli

Gmail: Read a message and extract its body or headers.

37.3K installs
gws-gmail-watch Similar name
googleworkspace/cli

Gmail: Watch for new emails and stream them as NDJSON.

33.8K installs
gws-gmail-reply Similar name
googleworkspace/cli

Gmail: Reply to a message (handles threading automatically).

31.7K installs

Also in this package

Other skills from finpeakinc/gws-cli · top by installs.

npx skills add finpeakinc/gws-cli
gws-shared 22 gws-gmail 19 gws-gmail-read 18 gws-gmail-triage 18 gws-gmail-reply-all 18 gws-gmail-reply 18 gws-gmail-forward 18 gws-gmail-send 17 gws-sheets-append 8 gws-sheets-read 8

Browse all from finpeakinc/gws-cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License LICENSE
Default branch main
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws gmail +watch --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,944 B
  • docs SUMMARY.md 77 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 18 installs

SKILL.md

gmail +watch

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Watch for new emails and stream them as NDJSON

Usage

gws gmail +watch

Flags

Flag Required Default Description
--project — — GCP project ID for Pub/Sub resources
--subscription — — Existing Pub/Sub subscription name (skip setup)
--topic — — Existing Pub/Sub topic with Gmail push permission already granted
--label-ids — — Comma-separated Gmail label IDs to filter (e.g., INBOX,UNREAD)
--max-messages — 10 Max messages per pull batch
--poll-interval — 5 Seconds between pulls
--msg-format — full Gmail message format: full, metadata, minimal, raw
--once — — Pull once and exit
--cleanup — — Delete created Pub/Sub resources on exit
--output-dir — — Write each message to a separate JSON file in this directory

Examples

gws gmail +watch --project my-gcp-project
gws gmail +watch --project my-project --label-ids INBOX --once
gws gmail +watch --subscription projects/p/subscriptions/my-sub
gws gmail +watch --project my-project --cleanup --output-dir ./emails

Tips

  • Gmail watch expires after 7 days — re-run to renew.
  • Without --cleanup, Pub/Sub resources persist for reconnection.
  • Press Ctrl-C to stop gracefully.

See Also

  • [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands