Skip to content
Development
Skill

/gws-events-subscribe

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

From plugin
cli
32k95 skills

Claude Code

$ npx -y skills add googleworkspace/cli --skill gws-events-subscribe --agent claude-code

SKILL.md

gws-events-subscribe.SKILL.md
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"

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
Read more
@googleworkspace
Ships withcli

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.

Stars on GitHub

Momentum

stars in total
32.1k
Star history of googleworkspace/cli on GitHub, a chart by star-history.com

Other skills on cli.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about gws-events-subscribe.

Which coding agents can use gws-events-subscribe?
gws-events-subscribe installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.