Gws Script Push

A straightforward CLI wrapper around Google's Apps Script API that lets you manage script projects from the command line. You can create new projects, pull down existing code, push local changes, run scripts remotely, and check execution metrics without opening the web editor. The real win is the push helper that syncs your local files to Apps Script, so you can use your preferred editor and version control. Authentication setup requires some initial Google Cloud configuration, but once that's done, it's solid for automating deployments or integrating Apps Script into larger workflows.

skills.sh installs: 26.7K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill gws-script-push --agent claude-code

Installs into .claude/skills of the current project.

Files

script +push

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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.

Details

Repository: github.com/googleworkspace/cli
Categories: Automation & Workflows, CLI & Terminal, Office & Documents
First seen: Apr 16, 2026