zarazhangrui/lark-coding-agent-bridge

해결하는 문제

이 프로젝트는 Feishu/Lark 메신저와 Claude Code 또는 Codex CLI 같은 로컬 AI 코딩 에이전트 사이의 브릿지를 제공합니다. 사용자는 채팅 인터페이스에서 로컬 개발 환경 및 코딩 에이전트와 직접 상호작용할 수 있어, 모든 상호작용을 위해 터미널을 계속 열어둘 필요가 없습니다.

작동 방식

이 브릿지는 Feishu/Lark에서 로컬 에이전트 프로세스로 메시지를 전달하는 미들웨어 역할을 합니다. 세션, 작업 디렉토리 및 파일 첨부 파일을 관리합니다. PersonalAgent 앱을 사용하여 메신저의 API에 연결하며, 첫 실행 시 QR 코드 마법사를 통해 구성할 수 있습니다.

대상 사용자

Claude Code 또는 Codex CLI를 사용하며, 편의성, 원격 액세스 또는 팀 협업을 위해 모바일 또는 데스크톱 채팅 앱(Feishu/Lark)을 통해 로컬 코딩 에이전트에 액세스하려는 개발자.

주요 특징

• 실시간 스트리밍: 텍스트 응답 및 도구 호출을 단일 Lark 카드에서 실시간으로 업데이트합니다.
• 세션 관리: 서로 다른 채팅, 주제 또는 문서 댓글 스레드에 대해 별도의 세션을 유지합니다.
• 워크스페이스 제어: /cd를 사용하여 프로젝트 디렉토리를 전환하고 /ws를 사용하여 이름이 지정된 워크스페이스를 저장할 수 있습니다.
• 액세스 제어: 기본적으로 비공개이며, 특정 사용자, 그룹 또는 관리자를 초대할 수 있는 세부 권한을 제공합니다.
• COT 프로세스 가시성: 최종 답변 전에 도구 호출 및 진행 텍스트를 포함한 에이전트의 "Chain of Thought (COT)" 프로세스를 선택적으로 표시합니다.
• 파일 처리: 채팅을 통해 전송된 이미지와 파일을 로컬 에이전트 환경으로 자동 다운로드합니다。
• 백그라운드 서비스: 지속적인 가용성을 위해 OS 관리 데몬(systemd, launchd 또는 Windows 작업 스케줄러)으로 실행할 수 있습니다.