<p align="center">
<img src="https://raw.githubusercontent.com/RongleCat/grok-app/HEAD/assets/logo.png" alt="Grok App Logo" width="128" height="128" />
</p>
<h1 align="center">Grok App</h1>
<p align="center"><strong style="font-size: 1.2em;">로컬 Grok Build CLI를 위한 현대적인 데스크톱 워크벤치</strong></p>
<p align="center"><em style="font-size: 1.1em;">다중 프로젝트 공간 (Multi-Project Spaces) · 실시간 에이전트 스트리밍 (Real-time Agent Streaming) · 통합 파일 및 코드 루프 (Integrated File & Code Loop) · 옴니채널 원격 IM (Omnichannel Remote IM) · 데스크톱 컴패니언 및 개인화 (Desktop Companion & Personalization)</em></p>
<p align="center"><a href="https://grok-app.com">https://grok-app.com</a></p>
<p align="center">
<a href="./README.md">English</a> ·
<a href="./README_ZH.md">中文</a> ·
<a href="./README_RU.md">Русский</a>
</p>
<p align="center">
<a href="https://grok-app.com"><img src="https://img.shields.io/badge/website-grok--app.com-0ea5e9" alt="Website" /></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License" /></a>
<a href="https://github.com/RongleCat/grok-app/stargazers"><img src="https://img.shields.io/github/stars/RongleCat/grok-app?style=social" alt="GitHub stars" /></a>
<img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey" alt="Platforms" />
<img src="https://img.shields.io/badge/Tauri-2-orange" alt="Tauri 2" />
<img src="https://img.shields.io/badge/note-unofficial-yellow" alt="Unofficial" />
</p>
<p align="center">
<a href="https://x.com/cgnot996"><img src="https://img.shields.io/badge/X-%E9%93%81%E6%9F%B1AGI%20%40cgnot996-black?logo=x&logoColor=white" alt="X 铁柱AGI" /></a>
<img src="https://img.shields.io/badge/WeChat-%E9%93%81%E6%9F%B1AGI-07C160?logo=wechat&logoColor=white" alt="WeChat 铁柱AGI" />
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/RongleCat/grok-app/HEAD/assets/wechat/mp-search-scan.png" alt="WeChat 검색 铁柱AGI — 스캔하여 팔로우" width="420" />
<img src="https://raw.githubusercontent.com/RongleCat/grok-app/HEAD/assets/wechat/community-group-qr.png" alt="WeChat 그룹 QR — 스캔하여 참여" width="200" />
</p>
[!NOTE]
Grok App 소개: Grok App은 로컬 Grok Build CLI (grok agent stdio)용 오픈 소스 데스크톱 클라이언트이자 워크벤치입니다. 이는 공식 xAI 제품이 아닙니다. 이 애플리케이션은 독점 모델 백엔드를 번들로 포함하지 않습니다. 모든 채팅 추론(chat reasoning), 도구 실행(tool execution), 권한 관리는 설치된 grok CLI를 통해 직접 실행됩니다.
전체 에이전트 기능은 설치 및 로그인된 Grok Build CLI가 필요합니다. 첫 실행 설정 마법사(setup wizard)는 CLI 설치를 지원할 수 있으며, UI 전용 개발은 GROK_APP_ACP=mock으로 실행할 수 있습니다.
목차
✨ 주요 하이라이트
⚡ 네이티브 빌드 세션(Native Build Sessions) — ACP 프로토콜을 통해 grok agent stdio와 깊게 통합됩니다. Grok 4.7 Extra High (xhigh)가 기본으로 활성화된 세분화된 권한 계층(질문(Ask), 일회 허용(Allow Once), 세션 허용(Allow for Session), YOLO 모드)을 제공합니다. Grok 4.7 Fast도 선택할 수 있습니다.
🗂️ 멀티 프로젝트 워크벤치(Multi-Project Workbench) — 격리된 프로젝트 작업 공간, 에이전트 상태 칸반 보드(Kanban), 원클릭 Git Worktree 전환, 모든 어시스턴트 답변에서 세션 포킹(session forking) 및 크로스-세션 컨텍스트 첨부 기능을 제공합니다.
📝 파일 및 생성 루프(Files & Creation Loop) — 즉각적인 디스크 동기화가 가능한 내장 CodeMirror 6 에디터, 시각적 Git Diff 검토 기능, 포괄적인 미디어 미리보기(이미지, 비디오, 오디오, PDF, Office 문서), 그리고 Imagine을 통한 AI 이미지/비디오 생성 기능을 갖추고 있습니다.
📲 옴니채널 원격 IM(Omnichannel Remote IM) — 로컬 에이전트를 Feishu/Lark, Telegram, Discord, Slack, DingTalk, WeCom, 위챗 개인 계정, QQ, Matrix, LINE, Weibo에 연결하는 통합 브릿지입니다. 토큰 기반 모바일 웹 미러 및 루프백 REST 세션 API를 지원합니다.
🐾 데스크톱 컴패니언 및 상태 피드백(Desktop Companion & Status Feedback) — 실시간 에이전트 상태 인지, 반응형 리액션, 알림 버블을 갖춘 상시 표시 데스크톱 펫 컴패니언입니다.
🔐 개인 정보 보호 및 사용자 지정 릴레이(Privacy & Custom Relays) — API 키는 OS 키체인에 안전하게 저장됩니다. SuperGrok 할당량 바와 히트맵 추적 기능, 사용자 지정 제공업체 릴레이(OpenRouter, Requesty, DeepSeek, AI98PRO 등), 그리고 15가지 내장 UI 언어를 지원합니다.
🛠️ 기능 개요
1. 현대적인 작업 환경 및 세션 관리(Modern Workbench & Session Management)
- 프로젝트 및 워크스페이스(Projects & Workspaces): 폴더 신뢰 시스템(Folder trust system), 워크스페이스 격리(workspace isolation), 가상화된 고성능 사이드바, 채팅 아카이빙, 크로스 프로젝트 마이그레이션, CLI 세션 가져오기 기능.
- 병렬 워크플로우(Parallel Workflows): 지속적인 백그라운드 스트리밍을 통한 다중 세션 동시 실행; 지능형 프로세스 관리 및 유휴 리소스 재활용; 칸반 보드 (Needs Input / Working / Done).
- Git Worktree 통합: 세션 내에서 원활하게 작업 디렉터리를 전환할 수 있도록 연결된 Git worktrees를 자동으로 감지합니다.
- 세션 포크 및 첨부(Session Forking & Attachment): 정렬된 컨텍스트 히스토리가 유지되는 상태에서 모든 어시스턴트 턴(assistant turn)으로부터 분기(branch off)할 수 있으며,
/attach-chat 또는 드래그 앤 드롭을 통해 최대 3개의 참조 세션을 첨부합니다.
2. 에이전트 상호작용 및 라이브 스트리밍(Agent Interaction & Live Streaming)
- 구조화된 타임라인(Structured Timeline): 생각 과정 추론(Thought reasoning), 도구 실행(tool executions), 최종 응답을 실시간 순서로 스트리밍하며 라이브 활동 표시기(live activity indicators)를 제공합니다.
- 파워 컴포저(Power Composer): 에이전트가 바쁜 동안 후속 프롬프트를 대기열에 추가할 수 있습니다.
Ctrl+Enter를 사용하여 현재 턴을 유도하고, 타이핑으로 포커스를 맞추거나, 프롬프트 히스토리, 선택된 인용구(selection quotes), 인라인 주석 기능을 활용합니다.
- 세분화된 권한 설정(Granular Permissions): 기본적으로 상호작용적 '질문하기' 확인 절차를 거치며, 한 번 허용, 세션별 허용, 프로젝트별 기본값 또는 비감독 YOLO 모드를 지원하고 워크스페이스 샌드박스(sandbox)를 지원합니다.
- 계획 및 목표 추적(Plan & Goal Tracking): 리소스 패널에 전체 Markdown 실행 상세 내용과 구조화된 마일스톤을 포함하여 다단계 계획 진행 상황을 표시합니다.
3. 파일, 미디어 및 생성 센터
- 앱 내 코드 및 텍스트 에디터: CodeMirror 6 멀티탭 에디터로, 실시간 양방향 파일 동기화 기능과 에이전트 수정 후 즉각적인 디스크 리로드 기능을 제공합니다.
- 시각적 변경 사항 및 Diff: 세션 수정 내용과 작업 공간의 Git diff를 확인하고, 개별 파일 또는 일괄 수락/거부/되돌리기(revert) 제어 기능을 사용할 수 있습니다.
- 리치 미디어 뷰어: 이미지, 비디오, 오디오, PDF 및 Word/Excel/PowerPoint 문서에 대한 네이티브 렌더링 및 미리보기를 지원하며, 고품질 공유 카드 이미지 내보내기 기능을 제공합니다.
- AI 에셋 생성: 'Imagine' 스킬을 사용하여 컴포저에서 이미지와 비디오를 직접 생성할 수 있으며, 로컬 웹 개발 미리보기를 위한 디자인 모드(Design Mode)가 통합된 사이드 브라우저를 제공합니다.
4. 확장 기능(Extensions), 플러그인 및 자동화(Automations)
- 슬래시 명령어 및 스킬: Grok Build 슬래시 명령어 팔레트, 인라인 스킬 칩, 사용자 지정 자동화 워크플로우(
/workflow)와 완벽하게 연동됩니다.
- 확장 기능 허브(Extensions Hub): 모델 컨텍스트 프로토콜(Model Context Protocol, MCP) 서버, 플러그인 카탈로그(OpenAI 플러그인 호환), 스킬, 에이전트 및 훅을 사용자 전체 제어권으로 관리할 수 있습니다.
- ChatCut 통합: 자동화된 OAuth 새로고침 및 외부 에디터 워크플로우를 갖춘 추천 Codex 플러그인에 대한 네이티브 통합을 제공합니다.
- 예정 자동화(Scheduled Automations): 자연어 프롬프트 생성과 시각적 실행 로그를 통해 반복적이거나 일회성 작업을 예약할 수 있습니다.
5. 원격 연결 및 크로스 디바이스 접근(Cross-Device Access)
- 11개 이상의 IM 채널 브릿지(IM Channel Bridges): 선호하는 메시징 앱에 연결하여 이동 중에도 로컬 데스크톱 에이전트를 모니터링하고, 재개하며, 제어할 수 있습니다 (
/p 프로젝트 전환, /r 재개).
- 모바일 웹 미러(Mobile Web Mirror): 모바일 브라우저용 경량 토큰 게이티드 웹 앱으로, 안전한 원격 액세스를 위해 Cloudflare Quick Tunnel과 호환됩니다.
- 로컬 세션 API(Local Session API): 스크립팅, CI 또는 타사 도구 통합을 위한 루프백 REST 엔드포인트(
GET /v1/sessions, POST /v1/sessions/{id}/turns)를 제공합니다.
6. 계정, 리레이 및 개인화 (Accounts, Relays & Personalization)
- 다중 계정 및 할당량 추적: 즉시 계정 전환기(instant account switcher), 공식 로그인, SuperGrok 할당량 진행률 표시줄, 비용 히트맵, 사용자 지정 제공업체를 위한 로컬 추적 기능.
- 유연한 리레이 모드: 독립형 구성 모드 또는 비파괴 공유 모드(기존
~/.grok 설정을 보호함); OpenRouter, Requesty, DeepSeek, AI98PRO 등에 대한 원클릭 프리셋 제공.
- 시각적 사용자 정의: 라이트(Light), 다크(Dark), 시스템 적응형 테마; 맞춤 스킨, 배경화면, UI 폰트, 터미널 폰트 및 공유 카드 스타일링.
- 국제화(Internationalization): 자동 OS 로케일 감지 기능을 갖춘 15개 내장 언어 (EN, ZH, JA, KO, DE, FR, RU, ES, PT-BR, IT, ID, TA, UK, FIL, ZH-TW).
📸 스크린샷 (Screenshots)
| 🖥️ Workbench & Sessions | 📊 Account & Quota Heatmap |
|---|
| Workbench | Account |
| ☀️ Light Theme Mode | 💬 Media Preview & Interaction |
|---|
| Light | Chat |
🚀 빠른 시작 및 설치 (Quick Start & Installation)
1. 사전 빌드 패키지 다운로드 (Download Prebuilt Packages)
공식 웹사이트 grok-app.com 또는 GitHub Releases에서 설치 파일을 직접 다운로드하세요:
| 플랫폼 | 패키지 형식 | 세부 정보 |
|---|
| macOS (Apple Silicon) | Grok_*_aarch64.dmg | Apple Silicon (M1/M2/M3/M4) Mac |
| ... | | |
💡 참고: 애플리케이션 번들 이름은 Grok입니다. 사전 빌드 패키지는 시스템에 Node.js, pnpm 또는 Rust 설치를 요구하지 않습니다.
체크섬 검증 (Checksum Verification)
각 릴리스에는 SHA256SUMS 파일이 포함되어 있습니다. 다음 명령어를 사용하여 다운로드 파일을 검증하세요:
shasum -a 256 -c SHA256SUMS --ignore-missing
...
2. 첫 실행 및 설정 (First Run & Setup)
- 실행(Launch): Grok App을 엽니다. 설정 마법사가 Grok Build CLI가 설치되었는지 자동으로 확인합니다 (다중 미러 빠른 설치 지원 포함).
- 계정/릴레이(Account / Relays) (선택 사항): 공식 계정으로 로그인하거나, API 키를 제공하거나, 사용자 지정 릴레이를 구성합니다. 로컬
grok CLI가 이미 인증된 경우, 단순히 **기존 CLI 로그인 사용(Use existing CLI sign-in)**을 선택합니다.
- 프로젝트 추가(Add Project): 프로젝트 작업 디렉터리를 선택하고 신뢰합니다.
- 에이전트 연결(Connect Agent): 질문(Ask) 또는 YOLO 권한 모드를 선택하고 데스크톱 에이전트를 사용하여 빌드를 시작합니다!
요구 사항 (Requirements)
- 로컬 Grok Build CLI (
grok) 0.2.112 이상 (업그레이드를 위해 터미널에서 grok update 실행).
- Windows: WebView2 Runtime 필요 (Windows 11에 사전 설치됨; 누락된 경우 설치 프로그램이 부트스트랩함).
- Linux AppImage: 호스트
libEGL.so.1 및 WebKitGTK 4.1 / Ayatana가 필요합니다 — 리눅스 런타임 라이브러리(Linux runtime libraries) 참조.
네트워크 및 프록시 구성 (Network & Proxy Configuration)
Grok 서비스를 직접 사용할 수 없는 제한된 네트워크 환경에서:
- **설정(Settings) → 런타임(Runtime) → 네트워크(Network)**로 이동하여 HTTP/SOCKS 프록시를 구성합니다 (예:
http://127.0.0.1:7890).
- **연결 테스트(Test connection)**를 클릭하여 엔드포인트(
auth.x.ai, grok.com 등) 연결성을 확인합니다. 프록시는 모든 에이전트 프로세스에 자동으로 주입됩니다.
macOS 게이트키퍼(Gatekeeper) / "손상된 앱(App is damaged)"
v0.2.19부터 시작하는 공식 릴리스는 Apple Developer ID로 서명되었으며 **Apple 공증(Apple-notarized)**되었습니다.
게이트키퍼가 실행을 차단하는 경우 (예: 서명되지 않은 사용자 지정 빌드 또는 격리 메타데이터로 인해):
xattr -cr /Applications/Grok.app
open /Applications/Grok.app
*또는 **시스템 설정(System Settings) → 개인 정보 보호 및 보안(Privacy & Security)**으로 이동하여 **어쨌든 열기(Open Anyway)*를 클릭합니다.
Windows SmartScreen 알림 (Windows SmartScreen Notice)
서명되지 않은 커뮤니티 패키지의 경우, Windows SmartScreen이 초기 실행 시 경고를 표시할 수 있습니다. **추가 정보(More info) → 그래도 실행(Run anyway)**을 클릭합니다. 무결성을 위해 파일 해시를 SHA256SUMS와 비교하여 확인할 수 있습니다.
타사 안티바이러스(Kaspersky 등 유사 제품)도 서명되지 않은 Tauri 앱과 번들된 CLI를 휴리스틱 위협으로 플래그 지정할 수 있습니다. 이는 커뮤니티 빌드에서 발생하는 오탐지(false positive)입니다. 설치 프로그램 해시를 확인하고, 설치 폴더와 앱 데이터 디렉터리(종종 %LOCALAPPDATA% 아래에 위치)를 제외하십시오. Authenticode로 서명하는 것이 장기적인 해결책입니다. 앱이 안티바이러스 내부에 스스로 화이트리스트 등록을 할 수는 없습니다.
리눅스 런타임 라이브러리 (AppImage)
공식 AppImage는 호스트 EGL/WebKit/트레이 라이브러리를 번들로 포함하지 않습니다. 깨끗한(clean) Debian/Ubuntu 설치 환경에서는 바이너리가 즉시 종료될 수 있습니다:
error while loading shared libraries: libEGL.so.1: cannot open shared object file
