larksuite/cli

lark-cli – Lark/Feishu용 명령줄 인터페이스

무엇인가요 – Go/Node로 작성된 오픈소스 CLI로, 인간과 AI 에이전트가 Lark/Feishu 생산성 스위트와 상호작용할 수 있도록 합니다. 2,000개 이상의 Open Platform API를 200개 이상의 즉시 사용 가능한 명령어와 AI 기반 자동화에 특화된 "스킬" 세트로 래핑합니다.

주요 기능

• 광범위한 커버리지 – 캘린더, 메신저, 문서, 드라이브, 스프레드시트, 슬라이드, 작업, 메일, 회의, OKR, 위키, 연락처, 승인, 출석, Base 테이블 등
• 3단계 명령어 모델
  1. 단축키 (+agenda, +messages-send) – 인간과 AI 모두 친화적이고, 기본값과 테이블 출력을 지원합니다.
  2. API 명령어 – Lark Open API 엔드포인트에 자동 생성된 1:1 매핑입니다.
  3. 로우 API – 2,500개 이상의 엔드포인트 중 어떤 것도 직접 호출 가능합니다.
• 에이전트 전용 "스킬" – 24개의 사전 패키지된 스킬 모듈(lark-calendar, lark-im, lark-doc 등)을 제공하여 AI 에이전트가 깔끔하고 타입 안정적인 인터페이스를 사용할 수 있도록 하며, 봇이나 기타 자동화 파이프라인에 쉽게 통합할 수 있습니다.
• 보안 우선 – OS 키체인 기반 자격 증명 저장, 입력 삽입 보호, 선택적 DPoP 증명, Feishu에 전송되는 정보는 최소한의 장치 정보만 전달되는 내장 리스크 제어 신호를 제공합니다.
• 설치 방법 – npx @larksuite/cli@latest install로 단일 라인 설치 또는 Go 1.23+로 소스에서 빌드 가능합니다.
• 인증 방법 – 인터랙티브 TUI를 통한 OAuth 흐름, 에이전트용 디바이스 코드 모드, 세밀한 범위 선택 기능이 있습니다.

누가 사용해야 하나요

• Lark 서비스에 빠르게 터미널 인터페이스가 필요한 개인 개발자
• Lark 데이터에 신뢰성 있고 구조화된 접근이 필요한 AI 어시스턴트, 봇, RPA 파이프라인을 개발하는 팀
• 내부 도구에 CLI를 통합하고 중앙 집중식 자격 증명 저장소와 감사 로깅을 원하는 기업

작동 방식 (개요)

1. 패키지를 설치합니다.
2. lark-cli config init를 실행하여 앱을 등록하고 클라이언트 ID/시크릿을 저장합니다.
3. 인증 (lark-cli auth login)을 수행합니다.
4. 명령어를 실행합니다 – 단축키 (lark-cli calendar +agenda) 또는 로우 API 호출 (lark-cli api GET /open-apis/calendar/v4/calendars)

출력 형식 – JSON(기본), 보기 좋게 포맷팅된 형식, 테이블, CSV, NDJSON로, 다른 스크립트나 AI 파이프라인에 결과를 쉽게 파이프할 수 있습니다.

위험 및 완화 조치 – README는 AI 에이전트가 의도치 않게 해로운 작업을 수행할 수 있음을 경고합니다. 기본 보호 기능(입력 정제, 제한된 토큰 사용 신호)이 활성화되어 있으며, 사용자는 이를 완화하지 말 것을 권고합니다.

라이선스 – MIT. Lark/Feishu 서비스 이용 약관을 준수해야 한다는 일반적인 요구 사항이 있습니다.

---

모든 세부 정보는 리포지토리의 README에서 직접 인용되었습니다.