
Gws Script Push
- 19.5k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
gws script-push module is a CLI interface for Google Workspace Apps Script deployment and management, integrated into the unified gws CLI with dynamic Discovery Service coverage.
About
A script-focused module of gws-cli for Google Workspace. Enables pushing, deploying, and managing Google Apps Scripts via command line with structured JSON output. Part of the unified Google Workspace CLI that dynamically discovers APIs from Google's Discovery Service.
- Google Workspace CLI for script operations: push, deploy, and manage Apps Scripts via CLI
- Same dynamic Discovery Service integration as core gws-script; 40+ bundled agent skills
- Structured JSON output for script metadata, deployment status, and execution results
Gws Script Push by the numbers
- 19,533 all-time installs (skills.sh)
- +847 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #22 of 560 CLI & Terminal skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-script-push capabilities & compatibility
- Capabilities
- script deployment · version management · execution tracking
- Platforms
- macOS · Linux · Windows
- IDEs
- vscode · cursor ide
- Runs
- Runs locally
- Pricing
- Free
npx skills add https://github.com/googleworkspace/cli --skill gws-script-pushAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 19.5k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
What it does
Deploy and manage Google Apps Scripts from CLI or CI/CD pipelines with structured JSON automation.
Who is it for?
Developers automating Google Apps Script deployment and management in CI/CD or agents
Skip if: Teams not using Google Apps Script or workflows that deploy exclusively through the browser Apps Script editor without local files.
When should I use this skill?
Need to deploy or manage Google Apps Scripts from CLI or automation workflows
What you get
Apps Script pushed, deployed, status tracked, execution results captured in JSON
- remote Apps Script project synced with local files
By the numbers
- Part of unified gws CLI with 40+ bundled skills
- Dynamic Discovery Service integration
Files
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 ./srcTips
- 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
How it compares
Use gws-script-push within the Google Workspace CLI ecosystem; use clasp when you standardize on Google's older standalone Apps Script CLI only.
FAQ
What command does gws-script-push use?
gws-script-push runs `gws script +push --script <ID>` to upload local files. An optional `--dir` flag points at the directory containing Apps Script sources when it is not the default layout.
What must be installed before gws-script-push?
gws-script-push requires the `gws` CLI binary and the shared gws auth rules from `gws-shared/SKILL.md`. If that file is missing, run `gws generate-skills` to create the prerequisite skill bundle.
Is Gws Script Push safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.