Grok Build 소개
최근의 AI 코딩 도구는 IDE 확장이나 웹 채팅 형태로 많이 등장하지만, 하루의 상당 시간을 터미널에서 보내는 개발자에게는 편집기와 챗봇 사이를 오가는 흐름이 오히려 번거로울 때가 있습니다. Grok Build는 이 지점을 정면으로 겨냥해, 코딩 에이전트를 터미널 전체 화면(TUI) 안으로 가져온 도구입니다. 명령어 이름은 grok이며, (x.AI의 새로운 이름인) SpaceXAI의 공식 터미널 기반 AI 코딩 에이전트입니다. 에이전트가 코드베이스를 이해하고 파일을 편집하며 셸 명령을 실행하는 과정을 하나의 화면 안에서 볼 수 있다는 점이 특징입니다. 즉 편집기, 셸, 대화창을 따로 띄우지 않고도 코드 작업의 대부분을 한자리에서 진행할 수 있습니다.
Grok Build는 세 가지 방식으로 사용할 수 있습니다:
(1)사람이 직접 화면을 보며 상호작용하는 대화형 모드, (2)스크립트나 CI에서 화면 없이 돌리는 헤드리스(headless) 모드, 그리고 (3) 에이전트 클라이언트 프로토콜(Agent Client Protocol, ACP)을 통해 편집기 안에 내장되는 방식입니다.
에이전트는 파일을 고치는 것에서 그치지 않고 셸 명령 실행과 웹 검색을 수행하며, 오래 걸리는 작업(long-running tasks)을 관리하는 역할도 맡습니다. 마우스 상호작용을 지원하는 전체 화면 인터페이스라, 스크롤백을 넘겨 보거나 변경 내역을 확인하는 동작이 터미널 안에서 자연스럽게 이뤄집니다. 이 세 가지 실행 경로 덕분에 개인 작업뿐 아니라 자동화 파이프라인과 편집기 연동까지 같은 에이전트로 커버할 수 있습니다.
구현은 Rust로 되어 있고, 저장소의 코드는 SpaceXAI의 모노레포에서 주기적으로 동기화됩니다. 저장소 루트의 SOURCE_REV 파일에는 현재 트리에 반영된 모노레포 커밋 SHA가 기록되어 있어, 어느 시점의 코드인지 추적할 수 있습니다. 본 게시물에서는 Grok Build의 계층 구조와 주요 동작, 설치와 빌드 방법, 그리고 라이선스 구성을 차례대로 정리합니다.
Grok Build의 구조 한눈에 보기
저장소 구성을 보면 Grok Build는 역할별 Rust 크레이트(crate)로 나뉘어 있고, 이들이 아래에서 위로 쌓이는 계층 구조를 이룹니다. 가장 아래의 워크스페이스(Workspace) 는 호스트 파일시스템, 버전 관리(VCS), 실행, 체크포인트를 담당해 에이전트가 실제로 손대는 환경을 관리합니다. 그 위의 도구(Tools) 계층에는 터미널, 파일 편집, 검색 같은 실제 도구 구현이 자리합니다.
도구 위에는 에이전트 런타임 크레이트가 있는데, 이 런타임이 리더(leader), stdio, 헤드리스 진입점을 제공합니다. 가장 위의 TUI 는 스크롤백, 프롬프트, 모달, 렌더링을 담당하는 화면 계층으로, 사용자가 마주하는 부분입니다. 이 밖에도 설정(config), MCP, 마크다운, 샌드박스(sandbox) 등 나머지 크레이트가 CLI를 이루는 의존성 묶음으로 함께 들어갑니다. xai-grok-pager-bin 크레이트가 이 전체를 조립하는 구성 루트(composition root) 역할을 하며, 빌드 결과물인 xai-grok-pager 바이너리를 만들어 냅니다.
Grok Build가 하는 일
Grok Build의 에이전트는 코드베이스를 이해한 뒤 파일을 편집하고, 셸 명령을 실행하며, 웹을 검색하고, 시간이 오래 걸리는 작업을 관리합니다. 이 동작들이 별도의 창이 아니라 하나의 전체 화면 TUI 안에서 이뤄지기 때문에, 변경된 파일 목록과 진행 중인 명령을 같은 화면에서 확인할 수 있습니다. 아래는 실제 TUI 화면으로, 좌측의 스크롤백과 우측의 작업 영역이 함께 표시되는 구성을 보여줍니다.
사용자 가이드는 xai-grok-pager 크레이트(crate)와 함께 배포되며, 키보드 단축키, 슬래시 명령(slash commands), 설정, 테마(theming), MCP 서버, 스킬(skills), 플러그인, 훅(hooks), 헤드리스 모드, 샌드박스 실행 등을 다룹니다. MCP 서버를 붙일 수 있다는 점은 외부 도구와 데이터 소스를 에이전트에 연결해 기능을 확장할 수 있다는 의미이고, 헤드리스 모드와 ACP 연동은 각각 자동화와 편집기 통합의 통로가 됩니다. 정리하면 Grok Build는 대화형 코딩 보조에 더해 스크립트·CI·편집기라는 서로 다른 실행 환경을 같은 에이전트로 아우르는 것을 목표로 합니다.
Grok Build 설치와 빌드
미리 빌드된 바이너리는 macOS, Linux, Windows용으로 배포됩니다. 설치 스크립트를 내려받아 실행한 뒤 버전을 확인하는 흐름입니다.
curl -fsSL https://x.ai/cli/install.sh | bash # macOS / Linux / Git Bash
irm https://x.ai/cli/install.ps1 | iex # Windows PowerShell
grok --version
소스에서 직접 빌드하려면 Rust 툴체인과 DotSlash, 그리고 protoc가 필요합니다. Rust 툴체인은 rust-toolchain.toml에 고정되어 있어 rustup이 첫 빌드 때 자동으로 설치하고, DotSlash는 bin/ 아래의 격리된 도구(대표적으로 bin/protoc)를 내려받아 실행하는 데 쓰이므로 빌드 전에 PATH에 올라와 있어야 합니다. macOS와 Linux가 지원되는 빌드 호스트이고, Windows 빌드는 이 트리에서 정식으로 검증되지는 않습니다.
cargo run -p xai-grok-pager-bin # 빌드 후 TUI 실행
cargo build -p xai-grok-pager-bin --release # 릴리스 바이너리: target/release/xai-grok-pager
cargo check -p xai-grok-pager-bin # 빠른 검증
빌드 산출물의 이름은 xai-grok-pager이며, 공식 설치본은 이를 grok이라는 이름으로 제공합니다. 바이너리를 처음 실행하면 브라우저가 열리면서 인증을 진행합니다. 참고로 저장소 루트의 Cargo.toml(워크스페이스 멤버, 의존성 버전, 린트, 프로파일)은 자동 생성되는 파일이라 읽기 전용으로 취급해야 하며, 수정이 필요하면 크레이트별 Cargo.toml을 고치는 방식이 권장됩니다.
Grok Build를 둘러싼 맥락
Grok Build 저장소는 외부 기여를 받지 않는다고 CONTRIBUTING.md 에 명시되어 있습니다. 코드가 SpaceXAI 모노레포에서 주기적으로 동기화되는 구조이기 때문에, 저장소는 소스를 열람하고 빌드해 쓰는 용도에 가깝습니다.
또 하나 눈여겨볼 부분은 도구 계층의 출처입니다. 저장소의 THIRD-PARTY-NOTICES 와 크레이트 로컬 고지 파일 에는 openai/codex와 sst/opencode의 도구 구현을 트리 안으로 이식(in-tree source ports)했다는 내용과 Apache §4(b)에 따른 변경 고지가 담겨 있습니다. 즉 터미널 코딩 에이전트 생태계에서 이미 검증된 도구 구현을 가져와 Rust 런타임 위에 얹은 셈입니다.
Grok Build의 라이선스
Grok Build 저장소의 1차(first-party) 코드는 Apache License 2.0으로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다. 다만 저장소에는 다른 프로젝트에서 가져온 서드파티·벤더링 코드가 함께 포함되어 있고, 이들은 각자의 원래 라이선스를 그대로 따릅니다. 앞서 언급한 openai/codex·sst/opencode 이식분과 벤더링된 Mermaid 다이어그램 스택이 여기에 해당하므로, 코드를 재사용할 때는 해당 고지 파일을 함께 확인하는 것이 좋습니다.
Grok Build 공식 홈페이지
Grok Build 문서 사이트
Grok Build 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. 
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 