Axe – 12MB 바이너리로 AI 프레임워크를 대체하는 Unix 철학 기반 CLI Agent 도구
Show HN: Axe – A 12MB binary that replaces your AI framework
TL;DR Highlight
TOML 설정으로 정의된 경량 LLM Agent CLI 도구는 Unix 파이프·git hook·cron 등 기존 도구와 조합하여 무거운 AI 프레임워크 없이도 재조합 가능한 Agent를 실행한다.
Who Should Read
LangChain 같은 무거운 AI 프레임워크 없이 LLM을 기존 개발 워크플로우(git hook, CI/CD, cron 등)에 간단하게 통합하고 싶은 백엔드/DevOps 개발자. 특히 커밋 메시지 생성, 로그 분석 같은 작은 자동화 작업에 LLM을 활용하고 싶은 경우에 유용하다.
Core Mechanics
- Axe는 'AI는 챗봇이어야 한다'는 전제를 거부하고, Unix 프로그램처럼 각 Agent가 한 가지 일만 잘 하도록 설계됐다. TOML 파일로 Agent를 정의하고 CLI에서 호출하며, 파이프로 데이터를 넘기고 결과를 받을 수 있다.
- Go로 작성된 단일 바이너리(12MB)로 배포되며, 별도 데몬이나 GUI 없이 동작한다. Anthropic(Claude), OpenAI, Ollama(로컬 모델) 세 가지 LLM 제공자를 지원한다.
- Agent 설정은 TOML 파일로 버전 관리가 가능하며, 각 Agent마다 시스템 프롬프트·모델 선택·스킬 파일·컨텍스트 파일·작업 디렉토리를 개별 지정할 수 있다.
- Sub-agent 위임(delegation) 기능이 있어서 Agent가 LLM 도구 호출(tool use)을 통해 다른 Agent를 호출할 수 있다. 무한 재귀를 막기 위한 depth 제한과 병렬 실행도 지원한다.
- Persistent memory 기능으로 타임스탬프가 붙은 마크다운 로그 형태로 실행 간 컨텍스트를 유지한다. LLM이 직접 오래된 메모리를 패턴 분석해 정리하는 'Memory garbage collection' 기능도 포함돼 있다.
- Skill 시스템을 통해 재사용 가능한 instruction 조각을 여러 Agent에서 공유할 수 있다. 예를 들어 'unix-output.md', 'be-concise.md', 'git.md' 같은 스킬 파일을 만들어서 여러 Agent에서 불러다 쓰는 방식이다.
- Axe 자체는 스케줄러가 아니라 실행기(executor)다. 스케줄링이나 워크플로우 오케스트레이션은 cron, git hook, 파일 와처 같은 기존 Unix 도구에 맡기고, Axe는 Agent 실행에만 집중한다.
Evidence
- 한 댓글 작성자가 비슷한 접근법을 쉘 스크립트로 직접 구현해서 사용 중이라는 경험을 공유했다. `git diff --staged | ai-commit-msg | git commit -F -` 같은 파이프라인을 만들었고, 각 Agent 스크립트는 bash로 작성해 스킬 파일을 불러오는 라이브러리를 공유하는 방식을 쓴다고 했다. Axe와 철학은 같지만 훨씬 가볍게 직접 구현했다는 점이 흥미롭다.
- 비용 통제에 대한 우려가 제기됐다. '거대한 컨텍스트 창 하나는 비싸지만, 작은 컨텍스트 창을 가진 10개 Agent가 의도치 않게 fan-out 되면 더 비쌀 수 있다'는 지적이다. 이에 대해 작성자는 명확한 답변을 내놓지 않았고, 커뮤니티에서도 이 부분이 미해결 과제로 남았다.
- 'Persistent memory'라는 용어에 회의적인 댓글이 있었다. 메모리 기능을 추가하면 스코프 크리프(기능이 의도치 않게 커지는 현상)나 복잡성 증가로 이어진다는 주장이다. '어떤 파일이 어떻게 파이프되는지 3문장으로 설명하지 못하는 memory 기능은 토큰만 낭비하는 추상화'라는 날카로운 비판이었다.
- 12MB 바이너리 크기가 크다는 지적이 있었다. Zig로 HTTP+TLS+LLM API 호출 스택을 구현하면 400KB, 언어/컴파일러/VM까지 구현해도 500KB 이하라는 비교가 나왔다. Go 런타임 특성상 어느 정도 불가피하지만, '12MB가 인상적인 수치'라는 홍보 방식에는 동의하지 않는다는 의견이었다.
- 단일 목적 Agent 모델에 대한 회의론도 있었다. '만약 Agent들이 사람이라면, 이렇게 세분화된 역할을 여러 사람에게 배분하고 협업시키는 건 완전히 비효율적일 것'이라는 지적이다. 반면 'Agent마다 필요한 컨텍스트만 주면 프롬프트가 작아져서 비용 통제와 동작 예측이 쉬워진다'는 긍정적인 반론도 있었다.
How to Apply
- git hook에 LLM 자동화를 붙이고 싶다면, Axe로 커밋 메시지 생성 Agent를 TOML로 정의하고 `.git/hooks/prepare-commit-msg`에서 `git diff --staged | axe run commit-writer`처럼 호출하면 된다. 프레임워크 설치 없이 바이너리 하나로 즉시 적용 가능하다.
- 여러 LLM 처리 단계를 파이프라인으로 연결하고 싶을 때, 각 단계를 별도 Agent TOML 파일로 정의하고 shell 파이프로 연결하면 된다. 예를 들어 `cat log.txt | axe run log-analyzer | axe run alert-formatter > alert.md` 식으로 구성하면 각 Agent가 최소한의 컨텍스트만 받아서 처리한다.
- Anthropic/OpenAI 클라우드 모델을 쓰다가 비용이 부담될 때, 같은 TOML 설정에서 model 필드만 Ollama 로컬 모델로 바꿔서 테스트해볼 수 있다. 멀티 프로바이더를 지원하기 때문에 프로바이더 전환 비용이 낮다.
- CI/CD 파이프라인에 코드 리뷰나 테스트 결과 요약 자동화를 추가하고 싶다면, GitHub Actions 워크플로우에서 Axe 바이너리를 다운로드해서 `axe run code-reviewer`를 실행하는 스텝을 추가하면 된다. 단일 바이너리라서 의존성 설치 없이 간단하게 통합된다.
Code Example
# TOML Agent 설정 예시 (예: commit-writer.toml)
[agent]
name = "commit-writer"
model = "claude-3-5-haiku-20241022"
system = "Given a git diff on stdin, output a single conventional commit message. One line only."
skills = ["core/unix-output.md", "core/be-concise.md", "domain/git.md"]
# CLI 사용 예시
$ git diff --staged | axe run commit-writer
$ git diff --staged | axe run commit-writer | git commit -F -
# 커뮤니티 댓글에서 공유된 bash Agent 스크립트 방식 (Axe 없이 직접 구현)
#!/usr/bin/env bash
# ai-commit-msg: stdin=git diff, stdout=conventional commit message
set -euo pipefail
source "${AGENTS_DIR:-$HOME/.agents}/lib/agent-lib.sh"
SYSTEM=$(load_skills \
core/unix-output.md \
core/be-concise.md \
domain/git.md \
output/plain-text.md)
SYSTEM+=$'\n\nTask: Given a git diff on stdin, output a single conventional commit message. One line only.'
run_agent "$SYSTEM"Terminology
관련 논문
adamsreview: Claude Code용 멀티 에이전트 PR 코드 리뷰 파이프라인
Claude Code에서 최대 7개의 병렬 서브 에이전트가 각각 다른 관점으로 PR을 리뷰하고, 자동 수정까지 해주는 오픈소스 플러그인이다. 기존 /review나 CodeRabbit보다 실제 버그를 더 많이 잡는다고 주장하지만 커뮤니티에서는 복잡도와 실효성에 대한 회의론도 나왔다.
Claude를 User Space IP Stack으로 써서 Ping에 응답시키면 얼마나 빠를까?
Claude Code에게 IP 패킷을 직접 파싱하고 ICMP echo reply를 구성하도록 시켜서 실제로 ping에 응답하게 만든 실험으로, 'Markdown이 곧 코드이고 LLM이 프로세서'라는 아이디어를 네트워크 스택 수준까지 밀어붙인 재미있는 사례다.
AI Agent를 위한 Git: re_gent
AI 코딩 에이전트(Claude Code 등)가 수행한 모든 툴 호출을 자동으로 추적하고, 어떤 프롬프트가 어느 코드 줄을 작성했는지 blame까지 가능한 버전 관리 도구다.
Agent-Native CLI를 위한 설계 원칙 10가지
AI 에이전트가 CLI 도구를 더 잘 사용할 수 있도록 설계하는 원칙들을 정리한 글로, 에이전트가 CLI를 도구로 활용하는 빈도가 높아지면서 이 설계 방식이 실용적으로 중요해지고 있다.
Agent-harness-kit: MCP 기반 멀티 에이전트 워크플로우 오케스트레이션 프레임워크
여러 AI 에이전트가 서로 역할을 나눠 협업할 수 있도록 조율하는 scaffolding 도구로, Vite처럼 설정 없이 빠르게 멀티 에이전트 파이프라인을 구성할 수 있다.
Tilde.run – AI Agent를 위한 트랜잭션 기반 버전 관리 파일시스템 샌드박스
AI 에이전트가 실제 프로덕션 데이터를 건드려도 롤백할 수 있는 격리된 샌드박스 환경을 제공하는 도구로, GitHub/S3/Google Drive를 하나의 버전 관리 파일시스템으로 묶어준다.