basecamp/hey-cli

해결하는 문제

이 프로젝트는 HEY 이메일 및 캘린더 서비스를 위한 명령줄 인터페이스(CLI)와 터미널 사용자 인터페이스(TUI)를 제공합니다. 사용자는 터미널을 떠나지 않고도 커뮤니케이션과 일정을 관리할 수 있으며, 특히 중요한 점은 AI 코딩 에이전트가 표준화된 인터페이스를 통해 사용자의 이메일 및 캘린더 데이터와 상호작용할 수 있도록 한다는 것입니다.

작동 방식

이 도구는 Go로 작성되었으며, HEY 서비스와 직접 통합됩니다. 주로 두 가지 운영 모드를 제공합니다:

1. TUI 모드: Mail, Contacts, Calendar, Journal에 접근할 수 있는 시각적 터미널 앱으로, HEY 자체의 키보드 단축키를 활용합니다.
2. CLI 모드: 스레드 읽기, 이메일 답장, 메시지 작성, 검색, 이벤트 관리 등을 위한 명령어 세트입니다. 인간이 읽기 쉬운 형식 또는 JSON 형식으로 출력하여 다른 도구에 파이프로 전달할 수 있습니다.
3. 에이전트 통합: Claude Code, Codex와 같은 AI 코딩 에이전트와 연결하기 위한 설정 마법사가 포함되어 있으며, 사용자의 HEY 계정을 AI 에이전트의 도구로 제공하는 MCP(Model Context Protocol) 서버로 작동합니다.

대상 사용자

• IDE와 이메일/캘린더 간 전환을 피하고자 하는 개발자
• 코딩 에이전트가 이메일을 읽고 쓰며 일정을 관리할 수 있도록 하고 싶은 AI 에이전트 사용자

주요 특징

• 에이전트 준비 완료: Claude Code, Codex 및 MCP 서버 기능을 내장하여 AI 에이전트를 강화합니다.
• 실시간 동기화: HEY 이메일 서비스와 실시간으로 동기화됩니다 (예: 스마트폰 앱에서 스레드를 아카이브하면 TUI에도 즉시 반영됨).
• 유연한 출력: JSON 출력과 내장된 --jq 필터링을 지원하여 스크립팅 및 자동화가 용이합니다.
• getline의 고유 도구: imbox, screener 등 HEY 전용 기능에 특화된 명령어를 제공합니다.
• 진단 도구: hey doctor 명령어로 설치, 인증, 에이전트 설정을 확인할 수 있습니다.