fx: Zig로 만든 작고 오픈된 네이티브 코딩 에이전트

Who Should Read

코딩 에이전트를 CI나 샌드박스에 가볍게 넣고 싶은 백엔드·DevOps 개발자

Core Mechanics

• Zig로 만든 6.66MiB 바이너리
  • fx는 Zig로 작성한 코딩 에이전트 하니스(모델을 감싸 도구를 실행하는 틀)이자 CLI다.
  • 터미널, CI, 에이전트 샌드박스에 바이너리 하나만 설치하면 된다.
• IDE보다 유닉스 셸에 가까운 출력
  • 스크롤 기록을 유지하고 도구 활동을 대화 안에 그대로 보여 준다.
  • 자세한 내용은 전체 transcript를 열어 확인한다.
• 컨텍스트를 아끼는 설계
  • 도구 스키마를 간결하게 만들었다.
  • 스킬 지침과 MCP 도구 스키마는 필요할 때만 불러온다.
• 임베딩과 WebAssembly 지원
  • libfx로 코어를 앱에 넣고 도구를 추가하거나 스킬·MCP 서버를 연결할 수 있다.
  • 브라우저에서도 돌릴 수 있고 저장소·도구·네트워크는 앱이 제어한다.
• 모델과 제공자에 구애받지 않는 설계
  • 로컬 모델, 게이트웨이, 직접 API 접근, 구독을 모두 염두에 두고 설계했다.
  • Apache-2.0 오픈소스이며 v0.0.14 experimental 상태라 변경이 잦다고 밝혔다.

Community Reactions

• 바이너리 크기에 의문을 던진 의견
  • 에이전트 루프는 단순해서 200~300KB면 충분할 것 같은데 왜 6MB냐는 의견이 있었다.
  • 레포를 받아 zig build 0.16으로 빌드하니 144MB, strip 후 44MB였다는 경험도 있었다.
• Vercel 외 제공자 연결이 막힌다는 경험
• 직접 API 키나 구독으로 로그인하는 방법을 5분 써 봐도 못 찾았다는 경험이 있었다.
  • 범용 OpenAI 호환 엔드포인트 옵션을 못 찾았다는 댓글도 여럿이었다.
• Zig 말고는 새로울 게 없다는 반론
  • 하니스는 대체로 비슷하고 Vercel 색만 입혔다는 의견이 있었다.
  • Go로 만든 하니스도 같은 이식성을 갖고 Vercel 샌드박스에 바로 배포된다는 경험이 있었다.
• 직접 써 본 반응과 대안
  • GLM 5.2를 무료 Vercel 계정으로 쓸 수 있었고 아주 매끄럽진 않지만 흥미롭다는 경험이 있었다.
  • C로 직접 만든 약 40KB 바이너리, Rust 기반 Maki, Nim 기반 3code가 대안으로 소개됐다.

How to Apply

• fx를 샌드박스에 설치해 보기
  • 격리된 환경에서 공식 설치 스크립트를 실행하고 fx ask로 요청 하나를 보내 본다.
  • experimental이므로 실제 프로젝트 대신 테스트 디렉터리에서 돌린다.
• 기존 에이전트와 시작 시간·메모리 비교하기
  • 지금 쓰는 에이전트 CLI와 fx를 같은 작업으로 돌려 시작 시간과 메모리를 재 본다.
  • CI나 컨테이너에 많이 띄워야 하는 경우에 판단 근거로 쓴다.
• 도입 전 제공자 연결부터 확인하기
  • 쓰려는 모델 제공자나 로컬 엔드포인트를 연결할 수 있는지 docs에서 먼저 확인한다.
  • 댓글에 연결이 막혔다는 경험이 있었으니 직접 API 키 로그인을 먼저 시험한다.

Try It

# Linux/macOS 터미널에서 실행 (격리된 샌드박스 권장)

curl -fsSL https://fx.sh/setup.sh | bash

# 설치 후 도움말 확인
fx --help

# 단일 요청 실행 (원문에 나온 fx ask)
fx ask "{{질문}}"

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://fx.sh
• https://github.com/antonmedv/fx
• https://maki.sh/
• https://3code.capocasa.dev/
• https://news.ycombinator.com/item?id=49006862