Index of every page on this site: llms.txt
All skills
googleworkspace avatar

/gws-events

@cd3697e
by Google Workspacegoogleworkspace/cli32k stars
1,997
Run it yourself

Subscribe to Google Workspace events.

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-events

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈12 tokens for metadata: the name and description. ≈824 when used: this file.

How this Skill uses context

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈50 characters, or 0.6%.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

events (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws events <resource> <method> [flags]

Helper Commands

Command Description
+subscribe Subscribe to Workspace events and stream them as NDJSON
+renew Renew/reactivate Workspace Events subscriptions

API Resources

message

  • stream — SendStreamingMessage is a streaming call that will return a stream of task update events until the Task is in an interrupted or terminal state.

operations

  • get — Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

subscriptions

tasks

  • cancel — Cancel a task from the agent. If supported one should expect no more task updates for the task.
  • get — Get the current state of a task from the agent.
  • subscribe — TaskSubscription is a streaming call that will return a stream of task update events. This attaches the stream to an existing in process task. If the task is complete the stream will return the completed task (like GetTask) and close the stream.
  • pushNotificationConfigs — Operations on the 'pushNotificationConfigs' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws events --help

# Inspect a method's required params, types, and defaults
gws schema events.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill provides a command-line interface for managing Google Workspace events using the vendor's 'gws' CLI tool. It allows the agent to subscribe to, list, and modify workspace notifications.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at cd3697e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 8 months ago
Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws events --help"
  }
}
  • CLI
  • google-workspace
  • events
  • subscriptions
  • gws
  • streaming
  • webhooks
  • task-management

README badge

README badge for googleworkspace/cli/gws-events

Manages Google Workspace event subscriptions and streams via CLI, exposing the Workspace Events API for creating, listing, updating, and deleting subscriptions. Includes helper commands to subscribe to events as NDJSON and renew suspended subscriptions.

Generated from the current SKILL.md.

What does this skill do?
This skill provides CLI access to the Google Workspace Events API, allowing you to create, manage, and subscribe to Workspace event subscriptions via the `gws` command.
What are the helper commands?
The skill includes `+subscribe` to stream Workspace events as NDJSON and `+renew` to reactivate suspended subscriptions.
Do I need to set up authentication first?
Yes. You must read `../gws-shared/SKILL.md` for auth setup and security rules before using this skill.
Can I list or delete existing subscriptions?
Yes. The skill supports `list`, `get`, `delete`, `patch`, and `reactivate` operations on the subscriptions resource.

Generated from the current SKILL.md. These answers refresh after source changes.