gws-cli-runner

Execute account-scoped Google Workspace CLI commands with OAuth profiles.

1|1|Updated Jul 24, 2014
One-click install
npx skills add https://github.com/rmanzoku/dotfiles --skill gws-cli-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-cli-runner
Source: https://github.com/rmanzoku/dotfiles/tree/main/skills/gws-cli-runner
Command: npx skills add https://github.com/rmanzoku/dotfiles --skill gws-cli-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the challenge of executing Google Workspace CLI (gws) commands with the correct account-scoped profile, ensuring security and privacy in multi-account environments.

Core Features & Use Cases

  • Account-Specific Command Execution: Safely run gws commands linked to specific Google accounts.
  • OAuth Profile Management: Handle OAuth profiles for personal or team accounts, reducing the risk of using the wrong credentials.
  • Fallback and Recovery: Includes mechanisms to recover or re-login only for the same selected profile, maintaining security.

Quick Start

Run a Google Workspace CLI command for your specific account profile: gws-account <profile> <command>

Frequently Asked Questions about gws-cli-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Google Workspace CLI commands for a specific account profile?

Run Google Workspace CLI commands for a specific account by using the gws-account wrapper, which ensures commands execute with the correct account-scoped OAuth profile. The syntax is gws-account <profile> <command>.

What is the best way to manage Google Workspace CLI security in multi-account environments?

Managing Google Workspace CLI security in multi-account environments requires account-scoped profiles to isolate OAuth credentials. This approach reduces the risk of using the wrong credentials by binding commands to specific personal or team accounts.

Do I need OAuth profile setup before executing Google Workspace CLI commands?

Yes, you need proper OAuth profile setup before executing Google Workspace CLI commands. The system relies on configured OAuth profiles and the gws-account wrapper functionality to handle secure profile switching and authorized access.

Can I re-login to a different Google Workspace account if my CLI command fails?

No, the fallback and recovery mechanisms restrict re-login to the same selected profile only. This maintains security by preventing unauthorized credential switching during Google Workspace CLI command execution.

Does the Google Workspace CLI runner work for team administrative workflows?

Yes, the Google Workspace CLI runner targets administrative and productivity workflows requiring Google Workspace management. It safely handles OAuth profiles for team accounts, ensuring secure operations across multiple users.