zerostack은 Rust로 작성된 최소주의 코딩 에이전트다. OpenCode와 Pi에서 영감을 받은 터미널 UI 기반 도구이며, JS 기반 코딩 에이전트보다 작은 바이너리와 낮은 메모리 사용량을 목표로 한다. GitHub 기준 ★151, GPL-3.0 라이선스다.
핵심 특징
| 기능 | 설명 |
|---|---|
| 다중 프로바이더 | OpenRouter, OpenAI, Anthropic, Gemini, Ollama, custom provider 지원 |
| 표준 코딩 도구 | 파일 읽기·쓰기, 셸 실행 등 코딩 에이전트 기본 도구 제공 |
| 권한 모드 | restrictive, standard, accept-all, yolo 네 가지 모드와 tool pattern 설정 |
| 세션 관리 | save/load/resume, 자동 compaction 지원 |
| 프롬프트 시스템 | code, plan, review, debug, ask, frontend-design 등 런타임 전환 |
| MCP 지원 | feature flag 기반 MCP 서버 연결 |
| Ralph loop | 장기 작업을 반복 실행하는 loop 시스템 제공 |
| git worktree | /worktree, /wt-merge, /wt-exit 명령으로 branch-per-task 흐름 지원 |
성능 지향
README 기준 zerostack은 약 7K LOC, 8.9MB 바이너리, 빈 세션 약 8MB RAM 사용을 목표로 한다. 무거운 데스크탑 앱이나 Node.js 기반 CLI 대신, 저사양 머신·원격 서버·장기 실행 세션에서 가벼운 코딩 에이전트를 원하는 사용자에게 맞다.
설치와 시작
cargo install zerostack
export OPENROUTER_API_KEY="[api_key]"
zerostack
zerostack -p "Explain this project"
zerostack -c
zerostack --provider openrouter --model deepseek/deepseek-v4-flash샌드박스 모드에는 bubblewrap을 사용할 수 있다.
어떤 경우에 적합한가
- Rust 기반의 작고 빠른 코딩 에이전트를 선호할 때
- 원격 서버에서 낮은 메모리로 AI 코딩 세션을 오래 유지하고 싶을 때
- Claude Code·OpenCode 같은 대형 하네스 대신 직접 통제 가능한 경량 도구를 원할 때
- 프롬프트 모드를 명시적으로 바꿔 plan/review/debug 흐름을 운영하고 싶을 때
관련 문서
- opencode — 오픈소스 AI 코딩 에이전트
- mini-coding-agent — 코딩 에이전트 핵심 구성 요소 학습용 프레임워크
- agent-harness — 하네스 엔지니어링
- long-running-agents — 장기 실행 에이전트 설계
참고 자료
- gi-dellav/zerostack — GitHub 공식 저장소