ByteRover CLI — AI 코딩 에이전트용 퍼머넌트 메모리 레이어
AI 코딩 에이전트의 “기억력” 문제를 해결하는 파일 기반 Context Tree. Anthropic의 에이전트 메모리 아키텍처를 기반으로 설계. 오픈소스 (4k★). OpenClaw Top memory 시스템으로 1주일 만에 3만+ 다운로드.
핵심 스펙
- 검색 정확도 92% 이상
- 평균 응답 1.6초
- 경량 모델에서도 90% 정확도 유지 → 토큰 50~70% 절감
- Git처럼 diff, branch, merge 가능한 inspectable 메모리 (black box 탈피)
Context Tree 구조
파일 기반 마크다운 계층 구조 (.brv/context-tree/):
.brv/context-tree/
├── market_analysis/ # Domain
│ ├── context.md
│ └── competitors/
│ ├── context.md
│ └── pricing.md # Context File
├── architecture/
│ ├── context.md
│ └── api/
│ └── auth.md
- Domain → Topic → Subtopic 3단계 계층
- 인간이 직접 읽고 수정 가능
- Git-friendly: diff, branch, merge 가능
- 벡터 DB 없음, 임베딩 없음 → 로컬 우선
핵심 기능
Agentic Search
- 기존 Vector DB + similarity search → Agentic Search로 교체
- LLM이 직접 파일 기반 구조를 탐색하여 검색
- 캐시 → 전체 텍스트 검색 → LLM 추론의 3단계 검색 전략
Stateful Memory Curation
- LLM이 샌드박스에서 코드를 실행하며 지식을 큐레이션
- ToolsSDK를 통해 LLM 생성 코드가 파일/코드 실행 가능
- 5가지 distinct operations로 큐레이션 수행
Daemon-First Architecture
- 백그라운드 데몬이 모든 실행 처리
- CLI 명령과 코딩 에이전트가 직접 연결
- TUI 불필요
지원 코딩 에이전트 (22개+)
| 에이전트 | 지원 방식 |
|---|---|
| OpenClaw | 최고 호환성 (전용 setup 스크립트) |
| Cursor | Skill 기반 (.cursor/skills/byterover/) |
| Claude Code | 지원 |
| Codex (OpenAI) | Skill + MCP |
| GitHub Copilot | Skill 기반 |
| Windsurf, Gemini CLI, OpenCode 등 | 지원 |
설치 & 사용
# 설치
curl -fsSL https://byterover.dev/install.sh | sh
# 또는
npm install -g byterover-cli
# 프로젝트에서 실행
cd path/to/project
brv
# 지식 추가
brv curate
# 검색
brv query
# 팀 동기화 (Git-like)
brv push
brv pull
# LLM 프로바이더 연결
brv providers connect openrouter --api-key your-key
# 코딩 에이전트 연결
brv connectors install "Claude Code"LLM 프로바이더 (18개 지원)
BYOK(Bring Your Own Key)로 18개 외부 프로바이더 연결 가능:
- OpenRouter, Anthropic, OpenAI, Groq, Ollama 등
- 로컬 모델 실행도 지원
- ByteRover 계정으로 내장 LLM 무료 사용 가능
Local vs Cloud
- 모든 기능 오프라인 기본 동작
- Cloud sync 옵션: 팀 간 메모리 공유, 다중 머신 접근, 백업
- 로컬 워크플로우 변경 없이 클라우드 추가 가능
ByteRover vs 기존 방식
| ByteRover | Vector DB 방식 | |
|---|---|---|
| 인프라 | 파일만 (zero infra) | 벡터 DB 프로비저닝 필요 |
| 검색 | Agentic Search | Similarity Search |
| 투명성 | 인간이 읽을 수 있는 마크다운 | 불투명한 임베딩 |
| 버전관리 | Git과 통합 가능 | 별도 관리 필요 |
| 비용 | 로컬 무료 | 임베딩 서비스 비용 |
관련 링크
- GitHub: https://github.com/campfirein/byterover-cli
- Docs: https://docs.byterover.dev/
- Blog: https://www.byterover.dev/blog/memory-architecture
- 출처: https://x.com/kevinnguyendn/status/2039719350798778688