AutoGineer
Generated banner for Gws Script
Generated logo for Gws Script

Gws Script

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Tool integration
  • Automation and integrations
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Manage Google Apps Script projects.
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-script skill provides a command-line interface for interacting with Google Apps Script projects. It allows developers to manage project metadata, retrieve script content, monitor execution processes, and handle deployments and versions, facilitating programmatic control over Apps Script development workflows.

What it does

  • Create new, empty Google Apps Script projects
  • Retrieve project metadata and source code content
  • List and monitor script execution processes
  • Access metrics regarding script executions and active users
  • Manage project deployments and versioning
  • Update project content by replacing existing files

When to use it

  • When automating the management of Google Apps Script projects
  • When you need to inspect script execution status or process logs
  • When integrating Apps Script project updates into a CI/CD pipeline
  • When retrieving project metrics for reporting or analysis

Advantages

  • Enables programmatic management of Google Apps Script resources
  • Provides direct access to project metadata and execution metrics
  • Supports version and deployment management via CLI
  • Integrates with existing terminal-based development workflows

Usage examples

“List all active processes for my Google Apps Script project.”
The agent executes the listScriptProcesses method to return the current status and types of processes associated with the specified script.
“Create a new empty script project.”
The agent triggers the project create method, resulting in a new script project with a base manifest file.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/googleworkspace/gws-script/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip gws-script.zip -d .agents/skills

Documentation by Google Workspace

script (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws script <resource> <method> [flags]

Helper Commands

CommandDescription
+pushUpload 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' resource

  • versions — Operations on the 'versions' resource

scripts

  • run —

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws script --help

# Inspect a method's required params, types, and defaults
gws schema script.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/gws-script · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-script.zip