- Tüm Google Workspace API'lerini tek bir CLI ile yönetebilen bir araçtır; Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin ve daha fazlasını destekler
- Google Discovery Service tabanlı olarak çalışma anında komut yapısını dinamik biçimde üretir; yeni API'ler eklendiğinde otomatik olarak yansıtılır
- Yapay zeka ajanları için 100'den fazla beceri içerir ve yapılandırılmış JSON çıktısı sayesinde LLM entegrasyonunu destekler
- OAuth, Service Account, CI ortamı gibi çeşitli kimlik doğrulama yöntemleri sunar ve Model Armor ile yanıt güvenliği özelliklerini destekler
- Hem insanlar hem de yapay zeka için otomasyon odaklı bir CLI olarak, Google Workspace ekosisteminde birleşik yönetim ve otomasyon verimliliğini artıran bir araçtır
Genel Bakış
gws, Google Workspace'e özel birleşik bir CLI'dır; Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin ve tüm diğer API'ler tek bir komut satırından çalıştırılabilir- Google Discovery Service aracılığıyla komut yapısını otomatik üretir; yeni API endpoint'leri eklendiğinde anında yansıtılır
- Tüm çıktılar yapılandırılmış JSON biçiminde sunulur; bu da yapay zeka ajanları veya otomasyon betikleriyle entegrasyonu kolaylaştırır
- Proje aktif olarak geliştirilmektedir ve v1.0 öncesinde önemli değişiklikler olabilir
Temel Özellikler
- Sekme tamamlama, --help, --dry-run, otomatik sayfalama gibi insan dostu CLI özellikleri sunar
- Yapay zeka ajanı entegrasyonu için
SKILL.md tabanlı 100'den fazla beceri içerir
- Gmail, Drive, Docs, Calendar, Sheets gibi temel hizmetler için 50'den fazla gelişmiş reçete içerir
- Gemini CLI uzantısı kurulduğunda Gemini ajanı
gws komutlarını ve becerilerini doğrudan çağırabilir
- MCP(Model Context Protocol) sunucu modu ile Claude Desktop, Gemini CLI, VS Code gibi ortamlarda Workspace API'lerini araç olarak sunabilir
Kimlik Doğrulama Yöntemleri
- Yerel etkileşimli kimlik doğrulama: AES-256-GCM ile şifrelenmiş kimlik bilgileri işletim sistemi anahtar zincirinde saklanır
- Manuel OAuth kurulumu: Google Cloud Console üzerinden doğrudan istemci oluşturulabilir
- Tarayıcı ve ajan destekli kimlik doğrulama: OAuth onayı manuel veya otomatik işlenebilir
- CI/sunucu ortamları için kimlik doğrulama:
gws auth export ile kimlik bilgileri dışa aktarılabilir ve ortam değişkeni olarak atanabilir
- Service Account ve önceden verilmiş token desteği vardır; öncelik sırası token > kimlik bilgisi dosyası > anahtar zinciri kaydı şeklindedir
Yapay Zeka Ajanı Becerileri
- Depoda yer alan 100'den fazla beceri, her API ve genel iş akışlarını otomatikleştirir
npx skills add komutuyla tüm veya tekil beceriler kurulabilir- OpenClaw ortamında beceriler sembolik bağlantı ya da kopyalama yoluyla senkronize edilebilir
gws-shared becerisi, CLI kurulu değilse otomatik kurulum özelliği içerir
Gemini CLI Uzantısı
gemini extensions install https://github.com/googleworkspace/cli komutuyla kurulur- Kurulumdan sonra Gemini CLI ajanı
gws komutlarını ve becerilerini doğrudan çağırabilir
gws kimlik doğrulama bilgilerini otomatik devralır; ayrı giriş yapmadan kullanılabilir
MCP Sunucu Özellikleri
gws mcp komutuyla MCP sunucusu çalıştırılarak Workspace API'leri MCP uyumlu istemcilere sunulabilir
- Örnek:
gws mcp -s drive,gmail,calendar
- Her hizmet 10 ila 80 araç ekler; istemcinin araç sınırına (50–100) göre seçim yapılabilir
--workflows, --helpers bayraklarıyla iş akışları ve yardımcı araçlar sunulabilir
Gelişmiş Özellikler
- Multipart yükleme: Dosya yükleme ve metadata oluşturma aynı anda yapılabilir
- Sayfalama kontrolü:
--page-all, --page-limit, --page-delay seçenekleri sunulur
- Model Armor entegrasyonu: API yanıtlarını tarayarak prompt injection'ı engeller
GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE, GOOGLE_WORKSPACE_CLI_SANITIZE_MODE ortam değişkenleriyle kontrol edilir
Mimari
- 2 aşamalı ayrıştırma yapısıyla çalışır
- İlk argümandan hizmet belirlenir
- Discovery belgesi alınır (24 saat önbellek)
clap::Command ağacı oluşturulur- Argümanlar yeniden ayrıştırılır ve kimlik doğrulama yapılır
- HTTP isteği yürütülür
- Tüm sonuçlar (başarı, hata, metadata) JSON yapısı olarak çıktı verir
Sorun Giderme
- API etkin değilse
accessNotConfigured hatası oluşur
- API'yi etkinleştirmek için
enable_url alanındaki bağlantıya tıklayıp yeniden deneyin
gws auth setup komutuyla gerekli API'ler otomatik etkinleştirilebilir
Geliştirme ve Dağıtım
- Apache-2.0 lisansı. Rust(99.5%)
- Resmî bir Google ürünü değildir; gayriresmî bir açık kaynak projedir
2 yorum
gog'dan farklı olarak, Google'ın tüm API'leri için dinamik olarak komut üreten yaklaşımı oldukça özgün görünüyor.Geliştiricisinin Justin Poehnelt olması ve Google Workspace DevRel'de çalışması da insana daha fazla güven veriyor.
Hacker News yorumları
AI ve MCP'ler çağında, şirketlerin bir anda düzgün API/CLI araçları oluşturmaya yöneldiği görülüyor
Bu, Workspace Studio'nun CLI sürümü gibi görünüyor
Google'ın, geliştiricilerin uygulamaları gerçekten kullanmak istediği yöne doğru hareket etmesi sevindirici
Google panolarına ya da özensiz üçüncü taraf kütüphanelere göre çok daha iyi görünüyor
Google bunun resmi destek olmadığını söylese de, dışarıya kıyasla içeride daha iyi desteklenme ihtimali yüksek
GCP Next 22-24 Nisan'da düzenlenecek
Umarım bu proje ondan sonra da yaşamaya devam eder
rustikilisini kurmak için nedennpmkullanıldığını merak ediyorumBu aralar ajan becerileri CLI istediği için, umarım bu akım bir trende dönüşür
Tüm CTO'ların bunu kendi OpenClaw instance'larına bağlamaya çalışırken heyecanlandığını gözümde canlandırabiliyorum
Kullanılabilir komutların dinamik olarak değişmesi bir anti-pattern gibi görünüyor, ama AI bunu idare edebilir belki
Keşke Apple da iCloud için aynı yaklaşımı benimsese
İlginç ama biraz korkutucu. Bu resmi bir Google ürünü değilse, TOS ihlali olabilir