Google Workspace CLI
Google Workspace (googleworkspace GitHub organization) · Programação
O Google Workspace CLI, que quase todo mundo chama de gws, é uma ferramenta de linha de comando gratuita e de código aberto que coloca Drive, Gmail, Calendar, Sheets, Docs, Chat e Admin atrás de uma única interface, para você nunca mais tocar na interface web. Em vez de escrever à mão chamadas curl contra a documentação REST, você roda um comando e recebe JSON estruturado. Ele foi criado para dois públicos ao mesmo tempo: desenvolvedores que querem automatizar o Workspace rápido e agentes de IA que precisam de saída legível por máquina e skills prontas. Essa divisão explica muita coisa.
Sobre Google Workspace CLI
O que é o Google Workspace CLI
O Google Workspace CLI é uma ferramenta baseada em Rust da organização googleworkspace no GitHub que envolve todas as APIs do Google Workspace em um único binário. A parte engenhosa é que ele não traz uma lista fixa de comandos. Lê o Discovery Service do Google em tempo de execução e monta sua superfície de comandos na hora, então quando o Google adiciona um endpoint de API, o gws o capta sem precisar de atualização. A saída é JSON estruturado por padrão, o que o torna tão útil para um script ou um LLM quanto para uma pessoa sentada no terminal.
O projeto é voltado para quem vive no Workspace o dia inteiro e quer parar de clicar na interface web, além da multidão crescente de desenvolvedores que conectam assistentes de IA a ferramentas de trabalho do dia a dia. Você se autentica uma vez com OAuth e depois lista arquivos, cria planilhas, envia mensagens no Chat ou puxa eventos de calendário a partir de um único shell. Ele também traz cerca de 40 skills de agentes de IA, então um assistente consegue gerenciar tarefas do Workspace sem nenhuma ferramenta personalizada. Nada de código de cola.
Um aviso importante: este não é um produto do Google com suporte oficial. Está em desenvolvimento ativo e os mantenedores avisam que mudanças que quebram a compatibilidade devem ser esperadas no caminho até a versão 1.0. Então você deveria se importar? Sim, se seus scripts precisam de estabilidade a longo prazo. A licença é Apache-2.0, e você precisa do seu próprio projeto no Google Cloud para as credenciais OAuth. Se você quer uma ferramenta polida e com estabilidade garantida, não é esta. Se quer uma que avance rápido e alcance todas as APIs do Workspace, é difícil superá-la. Escolha o seu equilíbrio.
Primeiros passos
- Instale o Node.js 18 ou mais recente, ou baixe um binário pré-compilado para o seu sistema operacional na página de GitHub Releases.
- Instale o gws com
npm install -g @googleworkspace/cli, ou use o Homebrew no macOS. - Rode
gws auth setuppara percorrer a configuração do projeto no Google Cloud e as credenciais OAuth. - Faça login com
gws auth loginusando uma conta do Google com acesso ao Workspace. - Teste um comando de verdade, como listar seus dez arquivos mais recentes do Drive, e confira a resposta JSON.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Google Workspace CLI.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores que automatizam tarefas do Workspace
- Criadores de agentes de IA
- Administradores de sistemas e equipes de TI
Tarefas
- Automatizar operações com arquivos do Drive
- Gerar relatórios no Sheets
- Enviar mensagens de Chat ou Gmail a partir de scripts
Cenários
- Integrar o Workspace a um pipeline de CI/CD
- Criar um assistente pessoal que agenda reuniões ou arquiva documentos a pedido.
- Administração em massa do espaço de trabalho em muitas contas e unidades compartilhadas.
Principais recursos
Superfície de comandos montada ao vivo a partir do Discovery Service
A CLI não fixa os comandos no código. Lê o Discovery Service do Google em tempo de execução, então cada endpoint e método da API do Workspace fica disponível como comando de forma automática. Quando o Google lança um endpoint novo, você o tem sem esperar por uma versão do gws. É isso que mantém a ferramenta atualizada de um jeito que wrappers estáticos não conseguem. Simples assim.
Saída JSON estruturada para agentes
Toda resposta volta como JSON estruturado. Para humanos, isso significa uma saída previsível e analisável que você pode encanar para o jq ou para um script. Para agentes de IA, significa que um LLM consegue ler e agir sobre os dados do Workspace sem nenhum código de cola. Essa é a razão central pela qual a ferramenta se vende tanto para desenvolvedores de agentes quanto para pessoas. A saída permanece limpa.
Skills de agentes de IA incluídas
Cerca de 40 skills de agente vêm com o projeto e cobrem os fluxos de trabalho mais comuns do Workspace. Em vez de escrever definições de ferramentas do zero, você pode colocá-las em um agente e deixar que ele cuide de tarefas do Drive, do Gmail ou do Calendar. Encurta o caminho de "tenho um LLM" para "meu LLM consegue gerenciar meu Workspace". Um grande atalho.
Ajuda integrada, simulações e paginação automática
Todo recurso aceita --help, então você pode explorar comandos sem sair do terminal. A flag --dry-run pré-visualiza a requisição antes de ela sair, o que é útil quando você está aprendendo um endpoint desconhecido. A paginação automática cuida de conjuntos de resultados grandes, então você não precisa escrever lógica de laço para percorrer centenas de arquivos do Drive ou mensagens do Gmail lote a lote.
Uma interface para todos os serviços do Workspace
Drive, Gmail, Calendar, Sheets, Docs, Chat e Admin ficam atrás da mesma estrutura de comandos. Você aprende o padrão uma vez e o aplica em todo lugar, o que reduz a troca de contexto que vem de malabarizar SDKs separados. Um único login cobre toda a superfície. É esse o ponto.
Opções de instalação multiplataforma
Você pode instalar o gws por npm, Homebrew, Cargo ou um flake do Nix, ou apenas baixar um binário pré-compilado para o seu sistema operacional. Essa flexibilidade faz com que ele caiba em quase qualquer ambiente de desenvolvimento, seja um notebook Mac, um servidor Linux ou uma máquina Windows.
Prós e contras
Prós
- Gratuito e de código aberto sob Apache-2.0, sem níveis pagos com que se preocupar.
- Cobre todas as APIs do Google Workspace por uma interface consistente.
- A integração com o Discovery Service ao vivo mantém o conjunto de comandos atualizado, o que facilita manter a automação do Google Workspace.
- A saída JSON e as skills de agente incluídas o tornam genuinamente útil para fluxos de trabalho com agentes de IA.
- Vários caminhos de instalação (npm, Homebrew, Cargo, Nix, binários pré-compilados) servem quase qualquer configuração.
Contras
- Não é um produto do Google com suporte oficial, então não há uma promessa formal de suporte do Google.
- Mudanças que quebram a compatibilidade são esperadas antes da versão 1.0, o que significa que os scripts podem precisar de atualizações após os lançamentos.
- A configuração exige o seu próprio projeto no Google Cloud e a configuração OAuth, um obstáculo real para quem não é desenvolvedor.
Perguntas frequentes
Sim. É de código aberto sob a licença Apache-2.0 e não custa nada. Você precisa de uma conta do Google e, para OAuth, de um projeto no Google Cloud, mas nenhum dos dois tem custo para uso pessoal ou de desenvolvedor típico.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a Google Workspace CLI.
Alternativas a Google Workspace CLI
Codeflying
Kuafu Technology (Codeflying) · Programação · Marketing · ChatbotO Codeflying é um criador de apps com IA que transforma uma descrição em linguagem natural em um site, um app móvel ou uma mini app que funcionam. Ele atua como criador de apps sem código, então você escreve o que quer e um conjunto de agentes de IA cuida dos requisitos, da arquitetura, das telas de front-end, da lógica de back-end e da implantação. O objetivo é simples: criar um app a partir de um prompt, mesmo sem nenhuma base em programação. Ferramentas de marketing e um agente de chat para clientes vêm incluídos também, então o resultado é mais do que um protótipo esquecido no disco rígido.
Runware
Runware, Inc. · Imagem · Vídeo · ProgramaçãoO Runware é uma plataforma de inferência de IA generativa que dá aos desenvolvedores uma única API para modelos de imagem, vídeo, áudio, 3D e linguagem. Em vez de se cadastrar em uma dúzia de provedores, você chama um só endpoint, troca de modelo com uma linha de código e paga apenas pelas requisições que envia. Nenhum servidor para manter. A ferramenta é voltada para equipes que querem lançar recursos de IA rápido sem montar nem cuidar da própria infraestrutura de GPU.
Aider
Aider AI LLC · ProgramaçãoO Aider é uma ferramenta de programação em par com IA de código aberto que vive no seu terminal. Você aponta para um repositório git local, descreve o que quer em linguagem natural e ela edita os arquivos, escreve os diffs e registra as mudanças por você. Conecta-se ao Claude, GPT, DeepSeek e Gemini pelas suas próprias chaves de API, e também roda modelos locais via Ollama ou qualquer endpoint compatível com a OpenAI. Desenvolvedores que já trabalham na linha de comando costumam adotar a ferramenta rápido. Ela não atrapalha. É aí que está todo o apelo.