gws

Manage Google Workspace services via the gws CLI from the terminal.

Updated Jul 10, 2023
One-click install
npx skills add https://github.com/iamtatsuki05/dotfiles --skill gws-iamtatsuki05
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws
Source: https://github.com/iamtatsuki05/dotfiles/tree/main/dotfiles/.agent/skills/gws
Command: npx skills add https://github.com/iamtatsuki05/dotfiles --skill gws-iamtatsuki05

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill enables controlling Google Workspace services (Calendar, Drive, Gmail, Tasks) directly from the command line, reducing context switching and enabling scripted workflows.

Core Features & Use Cases

  • Manage calendars: view agendas, create events, and modify schedules using gws calendar commands.
  • Read and send Gmail: triage messages, read mail, compose and reply with optional attachments.
  • Drive interactions: list, upload, and download files, search across Drive, and manage folders.
  • Task management: list tasks and tasklists, create or update tasks from prompts or scripts.
  • Security and workflow safety: require authentication, support dry-run, and confirm actions before execution.

Quick Start

Ask the AI to perform a routine workspace task, such as listing today’s calendar events with gws to verify credentials and context before execution.

Frequently Asked Questions about gws

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

FAQPage Schema
How do I manage Google Workspace services from the terminal?

The gws CLI requires Google Workspace authentication scopes and explicit safety prompts to guard against unintended changes before executing actions. It also supports dry-run modes to verify operations safely.

Can I read and send Gmail via the command line?

Yes, you can read and send Gmail via the command line using the gws CLI to triage messages, read mail, and compose or reply with optional attachments. This reduces context switching by keeping workflows within the terminal.

How do I list and upload files in Google Drive from a CLI?

You can list and upload files in Google Drive from a CLI using gws commands to search across Drive, manage folders, and download files directly. This enables seamless file management without leaving the terminal environment.

What is the best way to automate Google Calendar scheduling in scripts?

Automating Google Calendar scheduling in scripts is best handled by the gws CLI, which allows you to view agendas, create events, and modify schedules programmatically. It applies to both interactive queries and automated task workflows.

Do I need authentication scopes to manage Google Tasks from the command line?

Yes, you need Google Workspace authentication scopes to manage Google Tasks from the command line. The gws CLI requires explicit safety prompts and proper authentication to list tasklists, create tasks, and update task workflows securely.