RongleCat/grok-app

Grok App – 로컬 Grok Build CLI용 데스크톱 워크벤치

정의 – 오픈 소스, 크로스 플랫폼 데스크톱 클라이언트(Tauri 2로 구축)로, 풍부한 그래픽 워크벤치 내에서 로컬 grok 명령줄 에이전트(xAI의 "Grok Build" CLI)를 실행할 수 있습니다. 독점 모델은 포함되지 않습니다. 모든 LLM 추론, 도구 사용 및 권한 처리는 사용자가 설치한 grok 바이너리를 통해 이루어집니다.

핵심 기능(README 설명 기준)

영역	제공 기능
세션 및 프로젝트 관리	격리된 워크스페이스, 칸반 스타일 상태 보드, Git 워크트리 전환, 모든 어시스턴트 턴에서 세션 포크, 최대 3개의 참조 세션 첨부 가능.
실시간 에이전트 상호작용	에이전트의 생각, 도구 실행, 최종 답변의 실시간 스트리밍; 세분화된 권한 프롬프트(묻기, 한 번 허용, 세션 허용, YOLO); 에이전트가 바쁠 때 후속 작업을 대기열에 넣는 "Power Composer".
파일 및 미디어 루프	디스크와 즉시 동기화되는 통합 CodeMirror 6 편집기, 시각적 Git diff, 이미지, 비디오, 오디오, PDF, Office 문서 미리보기, 내장 Imagine 스킬을 통한 AI 이미지/비디오 생성.
옴니채널 IM 브리지	로컬 에이전트를 11개 이상의 메시징 플랫폼(Feishu/Lark, Telegram, Discord, Slack, DingTalk, WeCom, WeChat, QQ, Matrix, LINE, Weibo) 및 원격 제어용 토큰 게이트 모바일 웹 미러에 연결.
데스크톱 컴패니언	에이전트 상태를 표시하고 알림을 푸시하는 선택적 항상 위에 표시되는 "펫".
개인정보 및 릴레이	API 키는 OS 키체인에 저장, 사용자 정의 공급자 릴레이(OpenRouter, DeepSeek 등) 지원, 공식 SuperGrok 서비스의 할당량/히트맵 추적.
사용자 정의	라이트/다크/시스템 테마, 사용자 정의 스킨, 글꼴, UI 언어(15개 내장 로케일).

시작 방법

1. Grok Build CLI 설치(grok ≥ 0.2.112). 앱의 첫 실행 마법사가 설치를 도와줄 수 있습니다.
2. 사전 빌드 패키지 다운로드(macOS, Windows, Linux용) 웹사이트 또는 GitHub 릴리스에서. 바이너리에는 Node.js 또는 Rust 런타임이 필요하지 않습니다.
3. 앱 실행, 설정 마법사에 따라 CLI를 연결하거나 UI 전용 개발을 위해 GROK_APP_ACP=mock으로 모의 백엔드를 사용합니다.
4. 프로젝트 생성, 폴더를 신뢰하고 세션 시작 – UI가 에이전트 출력을 스트리밍하고 파일을 직접 편집할 수 있습니다.

기술 참고 사항(고급 사용자에게 유용)

• Tauri 2로 구축 – Vite 기반 웹 UI를 감싸는 가벼운 네이티브 래퍼.
• ACP 프로토콜 – 앱은 Agent Communication Protocol을 통해 grok agent stdio와 통신하여 세분화된 권한 처리를 가능하게 합니다.
• 크로스 플랫폼 주의 사항 – macOS는 공증됨, Windows는 SmartScreen 우회가 필요할 수 있음, Linux AppImage는 호스트 libEGL.so.1 및 WebKitGTK 4.1 필요(또는 .deb/.rpm 사용).
• 개발 – pnpm + Rust 툴체인; pnpm dev는 핫 리로드로 전체 데스크톱 실행, GROK_APP_ACP=mock pnpm dev는 CLI를 건너뜁니다.

누가 유용하게 사용할 수 있나요?

• 이미 로컬에서 Grok Build CLI를 사용하고 있으며 여러 프로젝트 관리, 파일 변경 보기, 에이전트 세션 기록 유지를 위해 GUI를 원하는 개발자.
• AI 지원 코딩, 콘텐츠 생성 또는 데이터 분석을 위해 일관된 데스크톱 환경이 필요하고 모든 데이터를 온프레미스로 유지하려는 팀.
• 로컬 에이전트를 외부 메시징 플랫폼에 연결하거나 내장 REST 세션 API를 통해 작업을 자동화하려는 고급 사용자.

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.