gws-admin-reports
Google Workspace Admin SDK: Audit logs and usage reports.
Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.
Claude Code
$ npx -y skills add googleworkspace/cli --skill gws-events-subscribe --agent claude-code
Codex
$ npx skills add googleworkspace/cli --skill gws-events-subscribe -a codex -y
Cursor
$ npx skills add googleworkspace/cli --skill gws-events-subscribe -a cursor -y
Gemini CLI
$ npx skills add googleworkspace/cli --skill gws-events-subscribe -a gemini-cli -y
GitHub Copilot
$ npx skills add googleworkspace/cli --skill gws-events-subscribe -a github-copilot -y
OpenCode
$ npx skills add googleworkspace/cli --skill gws-events-subscribe -a opencode -y
Windsurf
$ npx skills add googleworkspace/cli --skill gws-events-subscribe -a windsurf -y
name: gws-events-subscribe
description: "Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON."
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws events +subscribe --help"> **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
gws events +subscribe
| 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 |
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
> [!CAUTION] > This is a **write** command — confirm with the user before executing.
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.
Google Workspace Admin SDK: Audit logs and usage reports.
Google Calendar: Show upcoming events across all calendars.
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.