TL;DR

gws는 Google Workspace의 모든 공개 API를 단일 CLI 인터페이스로 제공하기 위해 설계된 도구로, Google Discovery Service를 런타임에 조회해 명령 트리를 자동 생성한다. 출력은 성공·오류·다운로드 메타데이터를 포함한 구조화된 JSON이고, 페이징을 NDJSON으로 스트리밍하는 등 파이프라인 처리를 고려한 기능을 제공한다. 인증은 대화형(OAuth), 헤드리스(CI용 export flow), 서비스 계정 등 여러 모드를 지원하고, Model Armor 템플릿으로 응답을 사전 검사할 수 있어 에이전트 통합 시 안전성 제어가 가능하다. 레포는 다수의 Agent Skills를 포함하며 Gemini CLI 확장으로 에이전트가 직접 gws 명령을 호출하게 할 수 있다. 사전 빌드 바이너리·npm·Homebrew·cargo·Nix 등의 설치 경로를 제공해 빠르게 도입할 수 있지만, 공식 Google 제품은 아니며 현재 활발히 개발 중이라 v1.0 전에는 파괴적 변경이 발생할 수 있고, OAuth 앱이 검증되지 않은 경우 scope 제한(약 25개)으로 로그인 실패 가능성이 있다.

핵심 포인트

• Google Discovery Service를 런타임에 읽어 clap 명령 트리를 자동 생성하므로 API 변경을 수동으로 유지관리할 필요가 없다
• 응답을 표준화된 JSON으로 출력해 LLM 에이전트와의 연동(스킬 + Gemini 확장)이 용이하다
• Model Armor 통합으로 API 응답에 대한 프롬프트 인젝션 검사(템플릿 기반)를 바로 적용할 수 있다
• 다중 설치 경로(바이너리, npm, Homebrew, cargo, Nix)를 제공해 배포·자동화 환경에 유연하게 적응한다