zerostack — Minimalist Coding Agent Optimized for Memory Footprint

technology coding-agentrustminimalistpimemory-optimizationzerostack

요약

🔗 원본: Reddit r/PiCodingAgent · zerostack 공식 사이트

Pi를 디자인 레퍼런스로 삼아 Rust로 만든 미니멀 코딩 에이전트. JS 기반 에이전트(~700MB)와 비교해 극도로 낮은 메모리 사용량(~16MB)이 핵심 특징. GPL-3.0 라이선스.

---

상세 분석

성능 벤치마크

항목	zerostack	JS 기반 에이전트 (비교)
코드 규모	~13,000 LoC	—
바이너리 크기	12.9 MB	—
RAM (평균)	~16 MB	~700 MB
RAM (피크)	~24 MB	—
CPU (유휴)	0.0%	—
CPU (작업중)	~1.5%	—

기능 목록

핵심 기능:

• 멀티 프로바이더 — OpenRouter, OpenAI, Anthropic, Gemini, Ollama (+ OpenAI 호환 엔드포인트)
• 권한 시스템 — 5단계 (restrictive / readonly / guarded / standard / yolo), per-tool 패턴, 세션 allowlist
• 터미널 UI — crossterm 기반, 마크다운 렌더링, 마우스 지원, 스크롤백
• 프롬프트 시스템 — 10개 내장 프롬프트, 런타임 전환 가능 (/prompt)
• 세션 관리 — 저장/불러오기/재개, 자동 압축
• MCP 지원 — 외부 도구 서버 연결
• 루프 시스템 — 장기 태스크용 반복 코딩
• Git Worktrees — 브랜치별 작업 워크플로
• ACP 지원 — 에디터 통합 (Zed 등)
• 샌드박스 모드 — bubblewrap / zerobox 격리
• Exa 검색 — WebFetch & WebSearch 도구
• 병렬 에이전트 — --parallel 플래그로 동일 레포에서 여러 에이전트 동시 실행

내장 프롬프트 (10종)

프롬프트	설명
code	기본 코딩 모드 (TDD 워크플로)
plan	코드 없이 탐색/계획만
review	코드 리뷰 (정확성, 설계, 테스팅, 영향)
debug	수정 제안 전 근본 원인 찾기
ask	읽기 전용 모드
brainstorm	코드 없이 아이디어 설계
frontend-design	독창적인 프로덕션 UI
review-security	취약점 찾기
simplify	동작 변경 없이 명확성 개선
write-prompt	에이전트 프롬프트 생성/최적화

권한 모드

모드	CLI 플래그	동작
restrictive	-R	모든 작업에 허가 요청
readonly	--read-only	읽기만 허용, 쓰기/편집/bash 거부
guarded	--guarded	읽기 허용, 쓰기/편집/bash는 허가 필요
standard	(기본값)	CWD 내 경로 도구 허용, 안전한 bash 자동 허용
yolo	--yolo	모든 것 허용, 파괴적 명령어만 확인

기타 명령어

/model — 모델 전환 /thinking — 사고 수준 설정 /clear — 대화 초기화 /session — 세션 목록/저장/불러오기 /loop — 반복 프롬프트 스케줄 /worktree — git worktree 생성 및 이동 /wt-merge — worktree 병합, 푸시, 정리, 복귀 /wt-exit — 병합 없이 메인 레포로 복귀

설치

cargo install zerostack
# 또는 ACP 지원
cargo install zerostack --features acp

---

Pi와의 관계

zerostack은 Pi의 디자인을 레퍼런스로 했지만, 두 가지 큰 차이점이 있음:

1. Rust 구현 — JS 대신 Rust로 작성되어 메모리/성능 면에서 유리
2. MCP 지원 — Pi와 달리 MCP를 기본 지원 (Pi는 Skills 권장)
3. GPL-3.0 오픈소스 — MIT 라이선스인 Pi와 라이선스 차이

커뮤니티 반응은 아직 없음 (게시 6시간 경과).

---

연결

• [[Pi Agent]] — 디자인 레퍼런스
• [[OpenCode → Pi 전환 논의]] — Pi 생태계 내 미니멀리즘 추구 흐름

인용

“~13k LoC, 12.9 MB binary, ~16 MB RAM. Peak RAM ~24 MB vs ~700 MB for JS-based agents.”