smallest-agent — 493바이트 코딩 에이전트

obra가 만든 smallest-agent는 단 493바이트(.js)로 동작하는 미니멀 코딩 에이전트. Claude API 기반으로 파일 읽기·쓰기·셸 명령을 수행하며, 모델 스스로 자신의 코드를 줄여(code golf) 완성했다.

핵심 정보

항목	내용
작성자	obra
언어	Shell (57.3%), JavaScript (42.7%)
크기	493 bytes (`src/smallest-agent.js`)
스타	72
라이선스	—

탄생 배경

“얼마나 미니멀하게 기능적 코딩 에이전트를 만들 수 있을까”라는 놀이에서 시작.

초안은 대략 Claude Code 수준의 기능
모델에게 자신의 코드를 줄이도록 지시
20분 만에 code golfing으로 493바이트까지 축소

구조

src/smallest-agent.js — 493바이트 실제 코드
src/smallest-agent.commented.js — 읽기 쉬운 변수명 주석 버전
npm test — 라이브 API 대상 스모크 테스트 (hi, uuidgen, 실패 셸 명령)

주의

⚠️ 무제한 Bash 접근 권한. 파일 삭제, 시스템 변경 등 모든 작업 가능. 사용 시 주의.

의의

에이전트가 자기 자신의 코드를 개선(code golf)하는 자기참조적 메타 작업의 실례
최소한의 에이전트 구조(프롬프트 → LLM → 도구 실행 → 루프)를 극단적으로 보여줌
2026-04-12-meta-hyperagents의 자기개선 개념과 맥락이 통함

관련 노트

2026-04-12-meta-hyperagents — Meta HyperAgents, 에이전트가 스스로 하네스를 설계
moc-claude-code — Claude Code 엔티티 페이지