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-shared
Shared authentication, global flags, and output formatting patterns for gws CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-sheets-append
Append rows to Google Sheets spreadsheets via CLI.
gws-sheets-read
Read values from Google Sheets spreadsheets via command line.
gws-slides
Read and write Google Slides presentations via CLI.
gws-tasks
Manage Google Tasks lists and tasks via CLI.