1MB 코딩 에이전트, C++로 다시 썼다

코딩 에이전트는 무겁다는 통념을 정면으로 뒤집는 프로젝트가 공개됐다. 오픈AI 코덱스(Codex)를 C++23으로 다시 구현한 마이크로코덱스(MicroCodex)는 1메가바이트가 채 안 되는 단일 실행 파일로 터미널에서 곧장 돌아간다. 아파치 2.0 라이선스로 전체 소스가 열려 있다.

무슨 일인가 / 배경

요즘 코딩 에이전트는 대부분 노드나 파이썬 런타임 위에 올라간다. 편리하지만 설치 용량이 크고 의존성이 얽히며, 서버나 컨테이너에 얹을 때마다 환경을 맞추는 일이 따라붙는다. 마이크로코덱스는 그 반대편을 택했다. 설치는 배포처 스크립트를 셸에 흘려보내는 한 줄이면 되고, microcodex login으로 로그인한 뒤 microcodex를 치면 바로 시작된다. 릴리스마다 맥OS용(애플 실리콘, x86_64)과 리눅스용(x86_64, arm64) 실행 파일이 함께 올라온다. 압축 파일 안에는 플랫폼 이름이 박힌 파일 하나만 들어 있어, 풀고 이름만 바꾸면 준비가 끝난다.

제공 기능은 원샷 프롬프트, 대화형 터미널 UI, 로컬 코딩 도구, 세션이 끊겨도 남는 대화, 자동 컨텍스트 압축이다. 대형 하네스에서 매일 쓰는 기능만 골라 담고 나머지를 덜어낸 구성이다.

핵심 짚어보기 — 에이전트의 실체는 얇은 루프다

이 프로젝트의 진짜 값어치는 소스 목록에 있다. 파일 이름만 훑어도 코딩 에이전트라는 것이 무엇으로 이뤄지는지가 그대로 드러나기 때문이다. 대화 상태를 관리하는 conversation, 모델을 호출하는 api와 http, 파일을 다루는 read·write·edit, 파일을 찾는 glob, 셸을 실행하는 bash와 그 위험을 걸러내는 bash-safety, 시스템 프롬프트, 도구 정의, 그리고 대화가 길어지면 자동으로 줄이는 context-compaction이 나란히 놓여 있다. 여기에 터미널 UI와 마크다운 렌더러, OAuth 로그인, 모델 카탈로그, 스킬 로더가 붙는다.

에이전트란 결국 도구 몇 개에 프롬프트와 컨텍스트 압축 루프를 얹은 것이라는 구조가 파일 목록에서 그대로 보인다. 특히 눈여겨볼 대목은 bash와 bash-safety를 굳이 분리한 설계다. 셸 실행 권한은 에이전트에게 가장 강력한 도구이자 가장 큰 사고 원인인데, 실행과 검증을 별개 모듈로 떼어놓으면 안전 규칙을 손보기 쉬워진다. 컨텍스트 압축을 처음부터 독립 모듈로 둔 것도 같은 맥락이다.

1인기업 실전 적용 포인트

• 자체 에이전트를 만들 계획이라면 이 저장소를 설계도로 쓴다. 읽기·쓰기·편집·검색·셸·압축 여섯 개면 실무형 에이전트의 골격이 선다. 처음부터 기능을 늘리는 대신 이 여섯 개를 확실히 만드는 편이 빠르다.
• 셸 실행에는 안전 필터를 반드시 별도 모듈로 둔다. 삭제·전송 계열 명령을 화이트리스트로 걸러야 사람이 지켜보지 않는 무인 운영이 가능해진다.
• 컨텍스트 자동 압축은 나중이 아니라 처음에 넣는다. 요약 단계가 없으면 긴 작업에서 토큰이 폭발하고, 그 비용은 그대로 월 고정비가 된다.
• 서버나 VPS에 얹을 자동화라면 경량 실행 파일형 에이전트를 후보에 올린다. 런타임 의존성이 없으면 이전 작업과 크론 등록이 훨씬 간단하고, 저사양 인스턴스로도 버틴다.

전망 / 주의점

공개 직후라 저장소는 커밋 44개, 스타 6개 수준의 초기 단계다. 실전 투입 전에 직접 빌드해 동작을 확인하는 절차가 필요하다. 윈도우용 실행 파일은 릴리스 목록에서 확인되지 않아 WSL 같은 우회가 필요해 보인다. 설치 스크립트를 셸에 바로 흘려보내는 방식도 그대로 따르기보다 내용을 먼저 열어보는 쪽이 안전하다. 그럼에도 대형 하네스가 무거워질수록 작고 읽을 수 있는 에이전트의 가치는 커진다. 코드 전체를 하루 안에 훑을 수 있는 규모라는 점이 이 프로젝트의 가장 큰 강점이다.

출처: GitHub (https://github.com/paoloanzn/microcodex)