cli
Uma CLI para o Google Workspace criada para humanos e agentes de IA.
Consulte o Drive, Gmail, Calendar e Sheets sem código repetitivo e com saída em JSON estruturado.
Esta é uma ferramenta de linha de comando que lê o Serviço de Descoberta do Google em tempo de execução para criar dinamicamente uma superfície de comandos para todas as APIs do Workspace. É ideal para desenvolvedores e assistentes executivos que desejam automatizar fluxos de trabalho ou alimentar dados do workspace em agentes de IA.
O que é
Executa chamadas de API em serviços do Google Workspace sem exigir listas de comandos estáticas e codificadas rigidamente. Cada resposta gera JSON estruturado, e inclui mais de 40 habilidades de agente e uma extensão Gemini CLI para execução automatizada de tarefas.
Para quem
É ideal para profissionais técnicos, administradores de sistemas e usuários avançados confortáveis com ferramentas de linha de comando e configuração de OAuth. Não é adequado para usuários leigos que esperam interfaces gráficas ou aplicativos de desktop simples guiados por assistentes.
Recursos principais
Superfície de Comando Dinâmica
Lê o Serviço de Descoberta do Google em tempo de execução para que novos endpoints de API adicionados sejam detectados automaticamente.
Saída em JSON Estruturado
Retorna JSON limpo para cada resposta, integrando-se diretamente com scripts de shell e agentes de IA.
Habilidades de Agente de IA Embutidas
Inclui mais de 100 habilidades de agente e uma extensão Gemini CLI para controle direto do workspace por LLMs.
Múltiplos Fluxos de Autenticação
Suporta configuração interativa, OAuth manual, contas de serviço e tokens de acesso pré-obtidos para ambientes de CI.
Pronto em 3 passos
Nosso veredito honesto
Pontos fortes
- Elimina a necessidade de escrever chamadas curl brutas para a documentação da API REST do Google.
- Transmite resultados paginados como NDJSON para facilitar a filtragem em pipelines com o jq.
- Fornece recursos de visualização de teste (dry-run) para ações de API destrutivas.
- Inclui um flake Nix e binários pré-compilados para várias plataformas.
Onde deixa a desejar
- Requer configuração manual de projeto no Google Cloud e configuração de tela de consentimento OAuth.
- Aplicativos OAuth não verificados no modo de teste atingem limites rígidos de escopo para contas gmail.com.
- Em desenvolvimento ativo, com alterações que quebram a compatibilidade esperadas antes da v1.0.
Preços & licença
A ferramenta é gratuita sob sua licença open source. O único custo associado é o seu tempo configurando um projeto no Google Cloud e qualquer uso potencial da cota da API do Google Cloud.
Vagas para quem fala português
880 vagas remotas abertas de treinamento de IA, atualizadas em 15 de novembro de 2026; a maioria paga $20–$175 por hora. 8 delas pedem falantes de português. O Zekai lista de graça; a candidatura vai para a plataforma do empregador.
Alternativas
Use, ou deixe que a gente configure
FAQ
Por que a configuração de autenticação do gws requer o gcloud?
Ele usa a CLI do gcloud para automatizar a criação do seu projeto no Google Cloud e habilitar as APIs necessárias.
Como lido com limites de escopo do OAuth no modo de teste?
Você deve selecionar serviços individuais usando flags como -s drive,gmail,sheets em vez de solicitar todos os mais de 85 escopos recomendados de uma vez.
Posso usar isso em ambientes de CI sem cabeçass (headless)?
Sim, exportando credenciais de uma máquina autorizada e definindo a variável de ambiente GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE.
