핏빗 웹 API의 공식 후속 서비스인 구글 헬스 API(Google Health API)를 감싼 오픈소스 명령줄 도구(CLI) ‘ghealth’가 공개됐다. 구글 헬스 API는 v4 버전부터 구글 OAuth 2.0 인증 방식으로 전환됐으며, ghealth는 이를 터미널과 AI 에이전트에서 손쉽게 활용할 수 있도록 감싸는 래퍼(wrapper) 도구다. Go 언어로 작성된 단일 바이너리 형태이며 아파치 2.0 라이선스로 배포된다.
ghealth는 걸음 수, 심박수, 수면, 체중, 산소포화도, 심박변이도 등 40가지 검증된 데이터 유형을 구조화된 JSON으로 제공한다. 심전도 같은 임상 데이터는 별도의 접근 권한(ecg.readonly 스코프)이 필요하다. 데이터 유형별로 조회, 집계, 일별 집계, 병합 등의 명령을 지원하며, 운동·수면·체중·체지방·신장 등 일부 유형은 생성·수정·삭제까지 가능하다. 여러 소스에서 겹치는 데이터를 하나로 합치는 병합 기능은 구글 헬스 API v4의 ‘조정된 스트림(Reconciled Stream)’ 개념을 그대로 반영한 것이다.
이 도구는 처음부터 AI 에이전트 연동을 염두에 두고 설계됐다는 점이 특징이다. 모든 명령은 일관된 형태의 단순화된 JSON과 예측 가능한 종료 코드를 반환하며, 실행 전 결과를 미리 확인할 수 있는 옵션과 원본 API 응답을 그대로 받는 옵션도 함께 제공한다. 저장소에는 인증·설정 방법과 40가지 데이터 유형의 사용법을 담은 문서가 포함돼 있어, 개발자가 클로드 코드나 코덱스 CLI 같은 AI 코딩 도구에 곧바로 설치해 쓸 수 있도록 했다. 설정은 ‘ghealth setup’ 명령 한 번으로 구글 클라우드 프로젝트 연결과 OAuth 인증 과정을 안내받는 방식으로 이뤄지며, 인증 정보는 이용자 로컬 환경에만 저장된다.
이 프로젝트는 ‘Google-Health-API’ 깃허브 조직 아래 공개돼 있으며, 같은 조직에는 기존 핏빗 오픈소스 저장소들도 함께 자리하고 있다. 아직 공식 제품은 아니지만 커뮤니티 주도로 개발된 다른 비공식 CLI들과 비교해 검증된 데이터 유형 수와 에이전트 친화적 설계에서 강점을 지닌 것으로 평가된다. 웨어러블 기기의 건강 데이터를 AI 에이전트의 맥락 정보로 손쉽게 연결하려는 개발자 커뮤니티의 수요가 이 같은 오픈소스 도구 확산으로 이어지고 있다는 분석이다.
저작권자 © STORIUM 무단전재 및 재배포 금지
