gws-chat

Manage Google Chat spaces, messages, members, and custom emojis via the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-chat-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-chat
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-chat
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-chat-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the need to write raw Google Chat API requests by exposing every Chat resource and method through the gws command-line interface, letting you manage spaces, messages, and emojis directly from the terminal. ## Core Features & Use Cases - Space Management: Create, update, delete, search, and list Google Chat spaces, including import-mode spaces and direct messages. - Messaging & Media: Send messages, upload attachments, and download media through the Chat API resources. - Custom Emojis & Members: Create, list, and delete workspace custom emojis and manage space memberships. - Use Case: A workspace administrator needs to provision a new team space, add initial members, and post a welcome message. Using this Skill, they run gws chat spaces setup followed by the send helper command without writing any API client code. ## Quick Start Ask the AI to list your Google Chat spaces or send a message to a specific space using the gws chat command.

Frequently Asked Questions about gws-chat

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

FAQPage Schema
How do I send a message to a Google Chat space from the command line?

Use the gws-chat-send helper skill, which wraps the messages.create method of the Google Chat API. First ensure gws authentication is configured via the gws-shared skill, then invoke the send command with the target space name and message text.

How do I create a Google Chat space with initial members?

Use the spaces.setup method via gws chat spaces setup, specifying memberships with users/{user} where {user} is the member's email address. The calling user is added automatically and should not be listed as a membership.

Can I manage custom emojis in Google Chat with gws?

Yes, the customEmojis resource supports create, delete, get, and list operations. Custom emojis require a Google Workspace account, and the administrator must enable custom emojis for the organization first.

Why does gws chat return a 404 when finding a direct message?

The findDirectMessage method returns 404 NOT_FOUND when no direct message space exists with the specified user. Create the DM space first or verify the user identifier is correct.

What prerequisites are required before using gws chat commands?

You need the gws binary installed and authentication configured as described in the gws-shared skill. If that shared skill is missing, run gws generate-skills to create it before calling any chat methods.