gws-script-push
googleworkspace/cli
Upload local files to a Google Apps Script project from your codebase.
What is gws-script-push?
This skill uploads local script files (.gs, .js, .html, appsscript.json) to a Google Apps Script project, replacing all files in the target project. Use it when you've edited Apps Script code locally and need to sync changes back to Google Workspace.
- Upload .gs, .js, .html, and appsscript.json files to Apps Script projects
- Automatically skip hidden files and node_modules directories
- Replace all files in the target project with local versions
- Support custom source directories via --dir flag
How to install gws-script-push
npx skills add null --skill gws-script-push- Google Workspace CLI (gws) installed and configured
- Valid Google Apps Script Project ID
- Authentication configured via gws-shared skill
How to use gws-script-push
- 1.Ensure your local files (.gs, .js, .html, appsscript.json) are ready in your working directory or specified --dir
- 2.Run gws script +push --script <SCRIPT_ID> to upload from current directory, or gws script +push --script <SCRIPT_ID> --dir ./src to upload from a specific folder
- 3.Confirm the operation when prompted (this is a write command)
- 4.Verify the files have been uploaded to your Apps Script project in Google Workspace
Use cases
- Push locally-edited Apps Script code to production after testing
- Sync a Git-managed Apps Script project to Google Workspace
- Deploy updated HTML templates and configuration files to an Apps Script project
- Bulk update multiple script files in a single operation
- Google Workspace developers managing Apps Script projects locally
- DevOps engineers automating Apps Script deployments
- Teams using version control for Apps Script code
gws-script-push FAQ
The skill supports .gs (Google Apps Script), .js (JavaScript), .html (HTML templates), and appsscript.json (project manifest) files.
Yes, this replaces ALL files in the project. Only files present locally will exist after the push.
Yes, use the --dir flag to specify a custom source directory: gws script +push --script SCRIPT_ID --dir ./src
Hidden files and node_modules directories are automatically skipped and not uploaded.
Yes, it's a write command that replaces all project files. Always confirm before executing and ensure you have a backup if needed.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-script-push description: "Google Apps Script: Upload local files to an Apps Script project." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws script +push --help"
script +push
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Upload local files to an Apps Script project
Usage
gws script +push --script <ID>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--script | ✓ | — | Script Project ID |
--dir | — | — | Directory containing script files (defaults to current dir) |
Examples
gws script +push --script SCRIPT_ID
gws script +push --script SCRIPT_ID --dir ./src
Tips
- Supports .gs, .js, .html, and appsscript.json files.
- Skips hidden files and node_modules automatically.
- This replaces ALL files in the project.
[!CAUTION] This is a write command — confirm with the user before executing.
See Also
- gws-shared — Global flags and auth
- gws-script — All manage google apps script projects commands
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.