gws-install

npx skills add jezweb/claude-skills --skill gws-install --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Google Workspace CLI — Quick Install Install `gws` on an additional machine using OAuth credentials from a previous setup. Produces an authenticated CLI with all agent skills ready to use. **Prerequisite**: The user must have `client_secret.json` from a previous `gws-setup` (or from Google Cloud Console). If they don't have it, use the `gws-setup` skill instead. ## Workflow ### Step 1: Pre-flight Checks ```bash which gws && gws --version ls ~/.config/gws/client_secret.json gws auth status ``` If already authenticated with the right scopes, skip to Step 4. ### Step 2: Install the CLI ```bash npm install -g @googleworkspace/cli gws --version ``` ### Step 3: Set Up Credentials Ask the user to provide their `client_secret.json`. Three options: **Option A — Paste the JSON content:** Ask the user to paste the JSON. Write it to `~/.config/gws/client_secret.json`: ```bash mkdir -p ~/.config/gws ``` Expected format: ```json { "installed": { "client_id": "...", "project_id": "...", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token", "client_secret": "...", "redirect_uris": ["http://localhost"] } } ``` **Option B — File path:** If the

which gws && gws --version
ls ~/.config/gws/client_secret.json
gws auth status
npm install -g @googleworkspace/cli
gws --version
mkdir -p ~/.config/gws
cp /path/to/client_secret.json ~/.config/gws/client_secret.json
export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id"
export GOOGLE_WORKSPACE_CLI_CLIENT_SECRET="your-client-secret"
gws auth login -s gmail,drive,calendar,sheets,docs,chat,tasks 2>&1 | tee /tmp/gws-auth-output.txt