Repolode
Enviar
googleworkspace

googleworkspace/cli

A command-line tool that gives one interface to Google Workspace APIs like Drive, Gmail, Calendar, Sheets, Docs, and Chat, with JSON output for scripts and AI agents.

Ver no GitHubSite
Estrelas
31,672
Forks
2,017
Issues abertas
136
Último commit
há 13 dias

O que é?

gws is a command-line client for Google Workspace. Instead of hand-writing curl calls against REST endpoints, you run commands such as gws drive files list or gws sheets spreadsheets create. The command set is built at runtime from Google's Discovery Service, so newly added API methods become available without a tool update. Every resource has --help, --dry-run previews a request before it is sent, and --page-all streams paginated results as NDJSON.

All output, including errors, is structured JSON, which makes the tool easy to pipe into jq or other scripts. The repository also ships over 100 Agent Skills (SKILL.md files) covering each supported API plus higher-level workflow helpers, and a Gemini CLI extension that lets an agent use the same commands with the authentication you already set up.

Authentication supports interactive OAuth login with encrypted local storage, manual Google Cloud OAuth client setup, service accounts, pre-obtained access tokens, and exported credentials for headless CI. Installation is available through GitHub Releases, npm, Cargo, Nix, and Homebrew. The project is written in Rust, is Apache-2.0 licensed, and is stated to be under active development with possible breaking changes before v1.0.

Recursos principais

  • 01Dynamically builds commands from Google's Discovery Service, so new API methods appear automatically.
  • 02Outputs structured JSON for every response, including errors.
  • 03Supports --dry-run to preview requests and --page-all for NDJSON pagination.
  • 04Ships 100+ Agent Skills and a Gemini CLI extension for AI agent use.
  • 05Offers multiple auth paths: interactive OAuth, service accounts, access tokens, and exported credentials for CI.

Casos de uso

  • Scripting routine Drive, Sheets, or Gmail operations from a terminal or CI job.
  • Letting an AI agent read calendars, send emails, or update spreadsheets through structured commands.
  • Automating Google Chat notifications, such as posting a message after a deploy.
  • Piping Workspace data into jq or other shell tools for reporting.

Tópicos

#google-workspace#cli#google-api#ai-agent#automation#oauth2#rust#agent-skills#discovery-api#gemini-cli-extension

Perguntas frequentes

O que é cli?
A command-line tool that gives one interface to Google Workspace APIs like Drive, Gmail, Calendar, Sheets, Docs, and Chat, with JSON output for scripts and AI agents. gws is a command-line client for Google Workspace. Instead of hand-writing curl calls against REST endpoints, you run commands such as gws drive files list or gws sheets spreadsheets create. The command set is built at runtime from Google's Discovery Service, so newly added API methods become available without a tool update. Every resource has --help, --dry-run previews a request before it is sent, and --page-all streams paginated results as NDJSON.
cli é gratuito? Qual é a licença?
cli é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
cli ainda é mantido?
Manutenção ativa. O último commit de cli foi em 6 de out. de 2026.
Para que posso usar cli?
Scripting routine Drive, Sheets, or Gmail operations from a terminal or CI job. Letting an AI agent read calendars, send emails, or update spreadsheets through structured commands. Automating Google Chat notifications, such as posting a message after a deploy. Piping Workspace data into jq or other shell tools for reporting.
Onde consigo cli?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/googleworkspace/cli

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados