gws-events-subscribe
bygoogleworkspace· 58 skills
Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.
How to install gws-events-subscribe?
googleworkspace/cli/gws-events-subscribe
$npx -y skills add googleworkspace/cli --skill gws-events-subscribeInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/googleworkspace/cli" --skill "googleworkspace/cli/gws-events-subscribe"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/googleworkspace/cli" that are relevant to the current task. Run `npx skills add "https://github.com/googleworkspace/cli"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | # events +subscribe |
| 2 | |
| 3 | > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. |
| 4 | |
| 5 | Subscribe to Workspace events and stream them as NDJSON |
| 6 | |
| 7 | ## Usage |
| 8 | |
| 9 | ```bash |
| 10 | gws events +subscribe |
| 11 | ``` |
| 12 | |
| 13 | ## Flags |
| 14 | |
| 15 | | Flag | Required | Default | Description | |
| 16 | |------|----------|---------|-------------| |
| 17 | | `--target` | — | — | Workspace resource URI (e.g., //chat.googleapis.com/spaces/SPACE_ID) | |
| 18 | | `--event-types` | — | — | Comma-separated CloudEvents types to subscribe to | |
| 19 | | `--project` | — | — | GCP project ID for Pub/Sub resources | |
| 20 | | `--subscription` | — | — | Existing Pub/Sub subscription name (skip setup) | |
| 21 | | `--max-messages` | — | 10 | Max messages per pull batch (default: 10) | |
| 22 | | `--poll-interval` | — | 5 | Seconds between pulls (default: 5) | |
| 23 | | `--once` | — | — | Pull once and exit | |
| 24 | | `--cleanup` | — | — | Delete created Pub/Sub resources on exit | |
| 25 | | `--no-ack` | — | — | Don't auto-acknowledge messages | |
| 26 | | `--output-dir` | — | — | Write each event to a separate JSON file in this directory | |
| 27 | |
| 28 | ## Examples |
| 29 | |
| 30 | ```bash |
| 31 | gws events +subscribe --target '//chat.googleapis.com/spaces/SPACE' --event-types 'google.workspace.chat.message.v1.created' --project my-project |
| 32 | gws events +subscribe --subscription projects/p/subscriptions/my-sub --once |
| 33 | gws events +subscribe ... --cleanup --output-dir ./events |
| 34 | ``` |
| 35 | |
| 36 | ## Tips |
| 37 | |
| 38 | - Without --cleanup, Pub/Sub resources persist for reconnection. |
| 39 | - Press Ctrl-C to stop gracefully. |
| 40 | |
| 41 | > [!CAUTION] |
| 42 | > This is a **write** command — confirm with the user before executing. |
| 43 | |
| 44 | ## See Also |
| 45 | |
| 46 | - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth |
| 47 | - [gws-events](../gws-events/SKILL.md) — All subscribe to google workspace events commands |
Related
6 picksType
- handoffCompact the current conversation into a handoff document for another agent to pick up.Jul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing…Jul 2026
- lark-eventLark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM…Jul 2026
- lark-vc-agent飞书视频会议会中能力：用于让应用机器人真实加入或离开正在进行的会议，并读取当前身份可见的会中事件、发送会中文本消息或会中表情。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容，或需要发现当前可读的进行中会议 ID。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询，这些使用 lark-vc 技能。Jul 2026
- ask-mattAsk which skill or flow fits your situation. A router over the skills in this repo.Jul 2026
- paperclip-create-agentCreate new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft…Jul 2026
