Gws events subscribe

Skill googleworkspace/cli/skills/gws-events-subscribe

Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.

Install

npx -y skills add googleworkspace/cli --skill gws-events-subscribe

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

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

SKILL.md

2.0 KB, as published. Nobody here has run it

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.