gws-events-subscribe

Subscribe to Google Workspace events and stream them as NDJSON.

8|1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/niclasmartinsson-sys/google-workspace-cli --skill gws-events-subscribe-niclasmartinsson-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-events-subscribe
Source: https://github.com/niclasmartinsson-sys/google-workspace-cli/tree/main/skills/gws-events-subscribe
Command: npx skills add https://github.com/niclasmartinsson-sys/google-workspace-cli --skill gws-events-subscribe-niclasmartinsson-sys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Subscribes to Google Workspace events and streams them as newline-delimited JSON (NDJSON) for real-time processing and integration with analytics pipelines.

Core Features & Use Cases

  • Subscribes to a configurable set of Workspace event types and streams events to stdout, files, or downstream services.
  • Supports common integration patterns such as Pub/Sub and event-driven automation; suitable for monitoring, auditing, and automation workflows.
  • Use Case: Real-time monitoring of chat and Drive activity to trigger alerts or record events for dashboards.

Quick Start

Run gws events +subscribe to begin streaming Workspace events in NDJSON to your terminal or output directory.

Frequently Asked Questions about gws-events-subscribe

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stream Google Workspace events as NDJSON for real-time monitoring?

To stream Google Workspace events as NDJSON, you use the gws CLI to subscribe to specific event types and output the real-time data stream to stdout, files, or downstream services for processing.

What Google Cloud prerequisites do I need to subscribe to Workspace event streams?

Subscribing to Workspace event streams requires the gws CLI installed and a configured Google Cloud project. You then use flags like --project, --subscription, and --event-types to define the streaming parameters.

Can I filter Google Workspace event types when subscribing to a Pub/Sub stream?

Yes, you can filter Google Workspace event types during subscription by passing the --event-types flag to the gws CLI, ensuring only relevant real-time events are streamed as NDJSON to your target output.

What is the best way to audit Google Workspace activity in real-time?

The best way to audit Google Workspace activity in real-time is subscribing to event streams via the gws CLI, which outputs continuous NDJSON data suitable for monitoring dashboards and automation workflows.

How do I direct real-time Workspace event streams to a specific output directory?

You direct real-time Workspace event streams to a specific directory by using the --output-dir flag with the gws CLI, saving the NDJSON formatted event data directly to your specified file path.

Does the gws events subscribe command support streaming to Pub/Sub topics?

Yes, the gws events subscribe command supports common integration patterns such as Pub/Sub, allowing real-time NDJSON event streams to be directed to downstream services and automation workflows.