gws-script

gws script

Reference: See the gws-shared skill for auth, global flags, and security rules.

Deploy and manage Google Apps Script projects using the gws CLI.

Helper Command

+push — Upload local files to an Apps Script project

Replaces ALL files in the target Apps Script project with files from a local directory.

gws script +push --script SCRIPT_ID
gws script +push --script SCRIPT_ID --dir ./src

Supported file types: .gs, .js, .html, appsscript.json

Automatic behavior:

• Skips hidden files and node_modules
• Replaces the entire project content (not a merge)

Raw API Access

You can also use the Apps Script API directly:

# List script projects
gws script projects list

# Get project content
gws script projects getContent --params '{"scriptId": "SCRIPT_ID"}'

# Get project metadata
gws script projects get --params '{"scriptId": "SCRIPT_ID"}'

Examples

Deploy a script from current directory

# Check what files will be uploaded
ls *.gs *.html appsscript.json

# Push to the project
gws script +push --script 1BxTjDmEZcABxhVBmFLRfMXD4eHJB7k_g2r-example

Deploy from a specific directory

gws script +push --script SCRIPT_ID --dir ./apps-script-src

View current project content before pushing

gws script projects getContent --params '{"scriptId": "SCRIPT_ID"}'

Caution

• +push replaces all files in the project — there is no merge or diff
• Always verify the script ID before pushing
• Consider keeping a backup of the current project content:

  gws script projects getContent --params '{"scriptId": "SCRIPT_ID"}' > backup.json
  

Tips

• Keep your Apps Script source files in a dedicated directory (e.g., ./apps-script/)
• Use version control (git) alongside +push for change tracking
• The appsscript.json manifest file controls runtime settings, scopes, and triggers