Labsco
googleworkspace logo

gws-events-subscribe

✓ Official★ 29,400

by Google · part of googleworkspace/cli

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

🔥🔥✓ VerifiedFreeQuick setup
#cloud#git#security
🧰 Not standalone. This skill ships with googleworkspace/cli and only works together with that tool — install the tool first, then add this skill.

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

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by Google

Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON. npx skills add https://github.com/googleworkspace/cli --skill gws-events-subscribe Download ZIPGitHub29.4k

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

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

Copy & paste — that's it
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 — Global flags and auth

  • gws-events — All subscribe to google workspace events commands