SkillsAdd

googleworkspace/cli · Official

gws-events-subscribe

Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.

All-time #808 Trending #1640 Hot #405 First seen Mar 4, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-events-subscribe
View on skills.sh ↗ GitHub repository ↗

Summary

  • Subscribe to Google Workspace events and stream them as NDJSON output.
  • Connects to Workspace resources (Chat spaces, Drive, Calendar, etc.) via CloudEvents types and streams events in real-time or batch mode Supports Pub/Sub-backed subscriptions with configurable polling intervals, batch sizes, and optional auto-acknowledgment Offers flexible output modes: stream to stdout, write individual events to files, or reuse existing subscriptions for reconnection Includes cleanup options to remove Pub/Sub resources on exit and one-shot polling with the --once flag

Similar popular skills

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

amazon-subscribe-save Similar name
nexscope-ai/amazon-skills

Subscribe & Save optimization — enrollment, discount tiers, frequency optimization, retention a…

10 installs

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 1, 2026

The skill provides documentation and usage instructions for the 'gws' CLI tool to subscribe to Google Workspace events. No malicious patterns or security risks were detected.

snyk LOW

Analyzed Apr 1, 2026

No issues detected.

socket Score 0.9000 · 0 alerts

Analyzed Apr 1, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli
gws-gmail 74.7K gws-gmail-send 69.5K gws-drive 68K gws-shared 59.4K gws-calendar 55.1K gws-sheets 52.5K gws-docs 52K gws-sheets-read 45.1K gws-docs-write 44.6K gws-calendar-agenda 44.2K

Browse all from googleworkspace/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

Stars 30.8K
License LICENSE
Default branch main
Open issues 129
Status Active

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 events +subscribe --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,077 B
  • docs SUMMARY.md 109 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 27,800 installs

SKILL.md

events +subscribe

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

Subscribe to Workspace events and stream them as NDJSON

Usage

gws events +subscribe

Flags

Flag Required Default Description
--target — — Workspace resource URI (e.g., //chat.googleapis.com/spaces/SPACE_ID)
--event-types — — Comma-separated CloudEvents types to subscribe to
--project — — GCP project ID for Pub/Sub resources
--subscription — — Existing Pub/Sub subscription name (skip setup)
--max-messages — 10 Max messages per pull batch (default: 10)
--poll-interval — 5 Seconds between pulls (default: 5)
--once — — Pull once and exit
--cleanup — — Delete created Pub/Sub resources on exit
--no-ack — — Don't auto-acknowledge messages
--output-dir — — Write each event to a separate JSON file in this directory

Examples

gws events +subscribe --target '//chat.googleapis.com/spaces/SPACE' --event-types 'google.workspace.chat.message.v1.created' --project my-project
gws events +subscribe --subscription projects/p/subscriptions/my-sub --once
gws events +subscribe ... --cleanup --output-dir ./events

Tips

  • Without --cleanup, Pub/Sub resources persist for reconnection.
  • Press Ctrl-C to stop gracefully.

[!CAUTION]
This is a write command — confirm with the user before executing.

See Also

  • [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-events](../gws-events/SKILL.md) — All subscribe to google workspace events commands