ONEDEV

cli

AI Agent FrameworksCLIGo

★ 17,229주당 +140조회 4

무엇인가

larksuite 팀이 유지하는 Lark/飞书 Open Platform 공식 명령줄 클라이언트다. 메신저, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, Markdown 등 업무 도메인을 터미널 명령으로 노출한다. 사람이 직접 입력하는 사용과 AI 에이전트가 도구 호출로 실행하는 사용을 동시에 전제로 설계됐다.

어떻게 동작하나

명령 체계는 세 층으로 나뉜다. `+` 접두가 붙는 Shortcuts는 사람과 에이전트 양쪽에 맞춘 기본값·표 출력·dry-run 미리보기를 제공하고, API Commands는 Lark OAPI 메타데이터에서 자동 생성돼 플랫폼 엔드포인트와 1:1로 대응한다. Raw API 층은 Open Platform 엔드포인트를 직접 호출한다. 인증은 앱 자격 증명 설정과 대화형 로그인 두 단계로 진행되며 자격 증명은 OS 네이티브 키체인에 저장된다. 출력은 `--format json`이 기본이고 성공 응답은 stdout과 종료 코드 0, 오류는 stderr와 비정상 종료 코드로 분리된다. 성공 여부는 `code == 0`이 아니라 `ok == true` 또는 종료 코드로 판정한다. `--dry-run`으로 부작용 가능 명령의 요청을 미리 보고, `schema`로 임의 API 메서드의 파라미터·요청 본문·응답 구조·지원 신원·스코프를 조회한다.

무엇과 다른가

OpenAPI를 HTTP로 직접 호출하거나 도메인별 SDK를 따로 붙이는 방식과 달리, 하나의 CLI 안에서 세 가지 세분도를 골라 쓴다. 빠른 작업은 Shortcuts, 플랫폼과 동기화된 표준 호출은 API Commands, 미지원 영역은 Raw API로 내려간다. 명령 파라미터는 실제 에이전트로 검증되며 간결한 인자·스마트 기본값·구조화 출력으로 호출 성공률을 맞춘다. AI 도구가 별도 설정 없이 쓸 수 있도록 Agent Skills가 함께 배포된다.

어떻게 쓰나

설치는 npm 경로와 소스 빌드 경로 두 가지다. npm 설치 후 앱 자격 증명 설정 명령을 백그라운드로 실행하면 인증 URL이 출력되고, 이를 사용자에게 전달해 브라우저에서 완료하면 명령이 종료된다. 이어서 로그인 명령을 같은 방식으로 수행하고 검증 명령으로 연결을 확인한다. 소스에서 빌드할 때는 Go v1.23+와 Python 3이 필요하다.

전제와 한계

Node.js(npm/npx)가 선행 조건이다. 에이전트가 사용자 신원으로 위임된 권한 범위 안에서 동작하므로 모델 환각·예측 불가 실행·프롬프트 인젝션 위험이 따르고, 민감 데이터 유출이나 권한 밖 조작으로 이어질 수 있다. 입력 인젝션 방지, 터미널 출력 정제, 키체인 자격 증명 저장이 기본으로 켜져 있으며 해제하면 위험이 커진다. 공식 Feishu/Lark HTTPS 도메인 요청에는 OS 종류와 기기 하드웨어 모델 수준의 위험 제어 신호가 기본 전송되고 워크스페이스 단위로 끄고 켤 수 있다. 봇은 비공개 대화 어시스턴트로만 쓰고 그룹 채팅에 추가하지 않는 것이 권장된다.

유사 도구