Grok Build 오픈소스 공개, 터미널 기반 AI 코딩 에이전트의 구조와 특징

SpaceXAI가 개발한 터미널 기반 AI 코딩 에이전트 Grok Build의 핵심 소스 코드와 에이전트 런타임이 오픈소스로 공개되었습니다. 이번 공개를 통해 Grok Build를 구성하는 Rust 기반 구조와 실행 방식, 빌드 환경, 저장소 구성 등을 확인할 수 있게 되었으며, 개발자는 AI 코딩 에이전트가 어떤 구조로 동작하는지 이해할 수 있습니다.

이번 글에서는 Grok Build의 역할과 주요 기능, 실행 방식, 설치 및 빌드 방법, 저장소 구조까지 입력된 내용을 기반으로 정리해보겠습니다.

반응형

---

Grok Build란?

Grok Build는 SpaceXAI의 터미널 기반 AI 코딩 에이전트입니다. 명령어는 grok을 사용하며, 전체 화면 TUI(Text User Interface) 환경에서 다양한 개발 작업을 지원합니다.

주요 기능은 다음과 같습니다.

• 코드베이스 이해
• 파일 편집
• 셸 명령 실행
• 웹 검색
• 장기 실행 작업 관리

Grok Build의 CLI와 TUI, 그리고 에이전트 런타임은 모두 Rust로 작성되어 있으며, 공개된 저장소는 SpaceXAI의 모노레포와 주기적으로 동기화됩니다.

---

다양한 실행 방식을 지원하는 AI 코딩 에이전트

Grok Build는 하나의 사용 방식만 제공하는 것이 아니라 다양한 개발 환경에 맞춰 세 가지 실행 방식을 지원합니다.

1. 터미널 대화형 실행

가장 일반적인 사용 방식으로 터미널에서 직접 AI와 상호작용하며 개발 작업을 수행할 수 있습니다.

2. 헤드리스(Headless) 실행

스크립트나 CI 환경에서 사용자 인터페이스 없이 실행할 수 있습니다.

3. Agent Client Protocol(ACP) 연동

ACP를 통해 편집기(Editor)에 내장하여 사용할 수 있습니다.

이처럼 동일한 에이전트를 다양한 환경에서 활용할 수 있도록 설계되어 있습니다.

---

바이너리 설치 및 인증 방법

Grok Build는 macOS, Linux, Windows용 사전 빌드 바이너리를 제공합니다.

macOS / Linux / Git Bash

curl -fsSL https://x.ai/cli/install.sh | bash

Windows PowerShell

irm https://x.ai/cli/install.ps1 | iex

설치가 완료되면 다음 명령으로 버전을 확인할 수 있습니다.

grok --version

첫 실행 시에는 브라우저가 열리며 인증 절차를 진행합니다.

또한 공식 설치판에서는 실행 파일 이름이 grok으로 제공되지만, 소스 빌드 결과물은 xai-grok-pager라는 이름으로 생성됩니다.

---

소스 빌드 환경

소스에서 직접 빌드하려면 다음 환경이 필요합니다.

• Rust
• protoc(Protocol Buffers)

Rust 도구 체인 버전은 rust-toolchain.toml에 고정되어 있으며, 첫 빌드 시 rustup이 자동으로 설치됩니다.

Protocol Buffers 코드는 우선 bin/protoc의 dotslash 런처를 사용하며, 사용할 수 없는 경우 PATH 또는 $PROTOC 환경 변수에 등록된 protoc를 사용합니다.

지원되는 빌드 환경은 다음과 같습니다.

운영체제	지원 여부
macOS	정식 지원
Linux	정식 지원
Windows	Best-effort(최선 노력) 지원

Windows는 현재 소스 트리 기준으로 테스트되지 않았습니다.

---

빌드 예제

소스를 이용한 대표적인 명령은 다음과 같습니다.

TUI 실행

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

컴파일 시간을 줄이면서 코드 검증만 수행할 때 사용할 수 있습니다.

---

Grok Build 저장소 구조

공개된 저장소는 기능별로 여러 Rust 크레이트(Crate)로 구성되어 있습니다.

xai-grok-pager-bin

구성 루트 패키지이며 xai-grok-pager 바이너리를 생성합니다.

xai-grok-pager

다음과 같은 TUI 기능을 담당합니다.

• 스크롤백
• 프롬프트
• 모달
• 렌더링

xai-grok-shell

에이전트 런타임을 담당하며 다음 기능을 제공합니다.

• Leader
• stdio
• 헤드리스 진입점

xai-grok-tools

개발 작업에 필요한 다양한 도구를 제공합니다.

• 터미널
• 파일 편집
• 검색

xai-grok-workspace

개발 환경과 직접 연결되는 기능을 담당합니다.

• 호스트 파일 시스템
• 버전 관리 시스템(VCS)
• 명령 실행
• 체크포인트 관리

기타 코드 구성

그 외에도 다음과 같은 기능을 위한 크레이트가 포함됩니다.

• 설정(Configuration)
• MCP
• Markdown
• 샌드박스

또한,

• crates/common/
• crates/build/
• prod/mc/

등은 의존성에 포함되는 공유 크레이트로 구성됩니다.

third_party/ 디렉터리에는 Mermaid 다이어그램 스택의 벤더링된 업스트림 소스가 포함되어 있습니다.

---

Cargo.toml 관리 방식

루트의 Cargo.toml은 워크스페이스 구성, 의존성 버전, 린트 설정, 프로파일 등을 기반으로 생성되는 파일입니다.

따라서 읽기 전용으로 취급하는 것이 권장되며, 설정을 변경해야 하는 경우에는 각 크레이트 내부의 Cargo.toml을 수정하는 방식이 권장됩니다.

---

제공되는 문서

사용자 가이드는 다음 경로에서 제공됩니다.

crates/codegen/xai-grok-pager/docs/user-guide/

문서에는 다음과 같은 내용이 포함됩니다.

• 시작하기
• 키보드 단축키
• 슬래시 명령
• 설정 및 테마
• MCP 서버
• 스킬 및 플러그인
• Hook
• 헤드리스 모드
• 샌드박싱

이를 통해 설치부터 실제 활용까지 필요한 내용을 확인할 수 있습니다.

---

라이선스 정책

공개된 자체 코드는 Apache License 2.0으로 배포됩니다.

다만 외부 기여(Contribution)는 받지 않으며, 저장소에 포함된 서드파티 및 벤더링된 코드는 기존 라이선스를 그대로 유지합니다.

---

728x90

Grok Build의 오픈소스 공개는 단순히 AI 코딩 도구를 사용할 수 있도록 하는 것을 넘어, 터미널 기반 AI 코딩 에이전트가 어떤 구조로 설계되고 동작하는지 확인할 수 있는 기회를 제공합니다.

특히 TUI 기반 인터페이스와 에이전트 런타임, 다양한 실행 방식(대화형·헤드리스·ACP), 기능별로 분리된 Rust 크레이트 구조는 개발 환경에 맞는 확장성과 유지보수를 고려한 구성을 보여줍니다.

또한 macOS, Linux, Windows용 바이너리 제공과 소스 빌드 환경, 사용자 가이드까지 함께 공개되어 있어 Grok Build의 구조와 사용 방식을 이해하는 데 필요한 정보를 확인할 수 있습니다. 앞으로 터미널 기반 AI 개발 도구와 에이전트 기술에 관심 있는 개발자들에게 참고할 수 있는 공개 사례가 될 것으로 기대됩니다.

300x250

https://github.com/xai-org/grok-build

GitHub - xai-org/grok-build: SpaceXAI's coding agent harness and TUI. Fullscreen, mouse interactive, extensible.