gws-apps-script▌
googleworkspace/cli · updated Apr 8, 2026
Manage and execute Google Apps Script projects via CLI with direct API access.
- ›Supports core operations: create projects, retrieve metadata and content, update script files, and execute scripts via the run method
- ›Includes process monitoring to list execution history and status for individual scripts or user-initiated processes
- ›Provides deployment and versioning operations for managing script releases
- ›Requires gws binary and authentication setup defined in shared skill documentatio
apps-script (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws apps-script <resource> <method> [flags]
Helper Commands
| Command | Description |
|---|---|
+push |
Upload local files to an Apps Script project |
API Resources
processes
list— List information about processes made by or on behalf of a user, such as process type and current status.listScriptProcesses— List information about a script's executed processes, such as process type and current status.
projects
create— Creates a new, empty script project with no script files and a base manifest file.get— Gets a script project's metadata.getContent— Gets the content of the script project, including the code source and metadata for each script file.getMetrics— Get metrics data for scripts, such as number of executions and active users.updateContent— Updates the content of the specified script project. This content is stored as the HEAD version, and is used when the script is executed as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. This clears all the existing files in the project.deployments— Operations on the 'deployments' resourceversions— Operations on the 'versions' resource
scripts
run—
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws apps-script --help
# Inspect a method's required params, types, and defaults
gws schema apps-script.<resource>.<method>
Use gws schema output to build your --params and --json flags.
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.6★★★★★63 reviews- ★★★★★Evelyn Srinivasan· Dec 12, 2024
I recommend gws-apps-script for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Ava Perez· Dec 12, 2024
Useful defaults in gws-apps-script — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Diya Liu· Dec 8, 2024
Useful defaults in gws-apps-script — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Hana Robinson· Dec 8, 2024
We added gws-apps-script from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Chaitanya Patil· Dec 4, 2024
Keeps context tight: gws-apps-script is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Diya Malhotra· Nov 27, 2024
gws-apps-script has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Piyush G· Nov 23, 2024
Registry listing for gws-apps-script matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Rahul Santra· Nov 3, 2024
We added gws-apps-script from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Michael Martin· Nov 3, 2024
Solid pick for teams standardizing on skills: gws-apps-script is focused, and the summary matches what you get after install.
- ★★★★★Hana Martinez· Nov 3, 2024
gws-apps-script has been reliable in day-to-day use. Documentation quality is above average for community skills.
showing 1-10 of 63