Gws Workflow File Announce
googleworkspace/cliOfficial
The gws-workflow-file-announce skill enables users to post announcements about Google Drive files directly to Google Chat spaces from the command line. It accepts a Drive file ID and Chat space identifier, retrieves the file metadata, and sends a formatted message to the specified space with optional custom text. This skill serves Google Workspace CLI users who need to quickly share and announce files across their organization without leaving the terminal.
- installs
- 30.9K
- GitHub stars
- 31.9K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add googleworkspace/cli --skill gws-workflow-file-announce --agent claude-codeInstalls into .claude/skills of the current project.
Files
workflow +file-announce
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Announce a Drive file in a Chat space
Usage
gws workflow +file-announce --file-id <ID> --space <SPACE>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--file-id | ✓ | — | Drive file ID to announce |
--space | ✓ | — | Chat space name (e.g. spaces/SPACE_ID) |
--message | — | — | Custom announcement message |
--format | — | — | Output format: json (default), table, yaml, csv |
Examples
gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123
gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123 --message 'Check this out!'
Tips
- This is a write command — sends a Chat message.
- Use
gws drive +uploadfirst to upload the file, then announce it here. - Fetches the file name from Drive to build the announcement.
See Also
- gws-shared — Global flags and auth
- gws-workflow — All cross-service productivity workflows commands
Sponsors
Details
- Repository
- github.com/googleworkspace/cli
- Categories
- Automation & Workflows, CLI & Terminal, Office & Documents
