Grok Build 오픈소스 공개: SpaceXAI의 터미널 코딩 에이전트

Who Should Read

Claude Code·Codex 같은 코딩 에이전트의 하네스 구조를 직접 뜯어보고 싶은 개발자

Core Mechanics

• 터미널용 AI 코딩 에이전트
  • Grok Build는 SpaceXAI의 터미널 기반 코딩 에이전트다.
  • 전체 화면 TUI(터미널 UI)로 코드베이스를 이해하고 파일을 고치며 셸 명령을 실행한다.
  • 웹 검색과 장시간 작업 관리도 한다.
• 실행 방식이 세 가지
• 대화형 TUI로 쓸 수 있다.
  • 스크립트·CI용 헤드리스 모드로 돌릴 수 있다.
  • ACP(Agent Client Protocol)로 에디터에 임베드할 수도 있다.
• Rust 워크스페이스 구조
  • TUI, 에이전트 런타임, 도구 구현, 워크스페이스(파일시스템·VCS·체크포인트)가 crate로 나뉘어 있다.
  • 실행 바이너리 이름은 xai-grok-pager이고 공식 설치본은 grok으로 배포된다.
• 라이선스와 기여 정책
  • 자체 코드는 Apache-2.0이다.
  • 외부 기여는 받지 않는다고 명시돼 있다.
  • SpaceXAI 모노레포에서 주기적으로 동기화되고, SOURCE_REV 파일에 커밋 SHA가 기록된다.

Community Reactions

• 코드 안에 의외의 기능이 있다는 의견
  • Mermaid 다이어그램을 유니코드 박스 문자로 그리는 터미널 렌더러가 들어 있다고 한다.
  • 제공 기능에 비해 코드량이 엄청나서 의도적으로 설계한 것 같지 않다는 의견도 있다.
• 공개 직후 포크가 여럿 나왔다는 정보
  • 텔레메트리를 제거한 프라이버시 포크(gork-build)가 있다.
  • 멀티 프로바이더 CLI, Tauri 데스크톱 GUI, 테마 포크도 있다.
• 사용자 데이터 업로드 논란을 언급한 의견
  • 작업 디렉터리 전체를 넘겨야 한다는 문제로 며칠 전 논란이 있었다는 댓글이 있다.
  • 데이터 삭제를 주장하지만 제3자 인증서가 제시되지 않았으니 신뢰할 수 없다는 의견이다.
• 샌드박스에서 돌리라는 조언
  • Docker Sandboxes로 실행하고 `sbx policy log`로 네트워크 요청 허용·차단을 확인하라는 팁이 있다.
  • 코드를 읽는 것을 대체하진 않는다는 단서가 붙었다.
• 모델 품질은 좋다는 경험담
  • 모델이 Opus 4.8보다 낫고 하네스도 매끄럽다는 개인 평가가 있다.
  • 반면 xAI 구독이면 pi.dev를 쓰라는 추천도 있다.

How to Apply

• 소스에서 빌드해 에이전트 구조 훑기
  • 오늘 `cargo run -p xai-grok-pager-bin`으로 빌드하고 TUI를 띄워라.
  • dotslash를 먼저 설치하고 `crates/codegen/xai-grok-tools`에서 도구 구현을 읽어라.
• 내 에이전트 도구 설계와 비교하기
  • 자체 에이전트를 만든다면 xai-grok-workspace의 체크포인트·실행 분리 구조를 우리 설계와 대조하라.
  • xai-grok-tools의 터미널·파일 편집·검색 도구 구현을 참고 목록으로 정리하라.
• 실행은 샌드박스 안에서 하기
  • 설치 스크립트를 바로 실행하지 말고 격리된 환경에서 먼저 돌려라.
  • 네트워크 허용 목록을 명시하고 요청 로그를 확인하라.

Try It

# 터미널(macOS/Linux)에 붙여넣기 - 소스에서 빌드해 Grok Build 실행

cargo install dotslash

git clone https://github.com/xai-org/grok-build
cd grok-build

cargo run -p xai-grok-pager-bin

# 이어서 해 볼 것: 도구 구현 폴더를 열어 에이전트 도구 목록 확인
# ls crates/codegen/xai-grok-tools

Terminology

관련 논문

• 같은 시뮬레이션, 다른 근거: 도구 출력을 파일로 넘기면 LLM 에이전트 정확도가 어디서 깎이나

  긴 툴 출력을 파일로 넘기자 GPT-5.1은 정확도 11.3%p 하락, 정식 출력 지정하니 회복

• 가짜 뉴스가 진짜 폭락을: LLM 트레이딩 에이전트 대상 정보 주입 공격

  가짜 헤드라인 한 줄로 LLM 트레이딩 에이전트 62%를 조종했다(프롬프트 주입은 14%)

• Harness Engineering 101: LLM은 뇌, harness는 몸

  에이전트는 JSON 배열을 관리하는 루프이고, 16개 챕터로 직접 만들어 본다

• Harness²: 에이전트 harness를 스스로 고쳐 쓰는 재귀 최적화 프레임워크

  모델은 고정하고 harness를 재귀로 고쳤더니 벤치마크 점수가 최대 11.8%p 올랐다

• 해고된 Savannah 경찰관, ICE 요원 남편에게 Flock 계정 공유

  경찰관이 Flock 계정을 남편(ICE 요원)에게 공유했고, 감사에서 983건 검색이 드러나 해고됐다

• tmux와 Claude Code: 세션, send-keys, 그리고 한계선

  tmux로 Claude Code 여러 개를 돌리면 편하지만 에이전트 4개쯤에서 한계가 온다

• Hybrid Reasoning Agents: 잠재 공간에서 생각하고 텍스트로 행동하는 LLM 에이전트

  잠재 공간 추론과 텍스트 도구 호출을 섞었더니 성능 10.4%↑, 토큰 최대 54.7%↓

Related Resources

• https://github.com/xai-org/grok-build
• https://news.ycombinator.com/item?id=48928913
• https://github.com/thedavidweng/gork-build
• https://github.com/DigiGoon/digi-grok-build
• https://github.com/victor-software-house/open-grok
• https://github.com/LukaMucko/grok-build
• https://github.com/RapidAI/grok-build-desktop
• https://github.com/mazdak/grok-build
• https://github.com/thomas9120/grok-build-archival
• https://github.com/saqoah/grok-build
• https://pi.dev
• https://github.com/docker/sbx-kits-contrib/pull/156