ONEDEV

byterover-cli

AI MemoryCLITypeScript

★ 4,957주당 +5조회 4

무엇인가

ByteRover CLI는 AI 코딩 에이전트에 붙이는 휴대용 기억 계층이다. 에이전트 자체를 만드는 도구가 아니라, 에이전트가 참조할 프로젝트 지식을 모으고 보관하고 배포하는 쪽을 맡는다. 실행 파일 이름은 `brv`이고 이전 이름은 Cipher다.

어떻게 동작하나

`brv`를 프로젝트 디렉터리에서 실행하면 React/Ink로 만든 TUI REPL이 뜬다. REPL은 Anthropic, OpenAI, Google, Groq, Mistral, xAI, DeepSeek 등 여러 LLM 제공자 중 선택한 곳에 연결된다. 에이전트는 코드베이스의 agentic map으로 프로젝트를 파악하고, 코드 실행·파일 조작·지식 검색·메모리 관리 같은 내장 도구를 쓴다. 큐레이션된 지식은 프로젝트의 컨텍스트 트리에 쌓이고, 프로젝트 루트의 `.brv/config.json`이 그 루트를 소유한다. `brv curate`는 지식 변경을 제안하고 승인·거부 리뷰 단계를 거친다. `brv query`는 결과가 로컬에서 온 것인지 공유 공간에서 온 것인지 origin으로 구분한다. 컨텍스트 트리는 `brv vc`로 branch, commit, merge, push/pull을 수행한다.

무엇과 다른가

임베딩 인덱스만 두는 RAG 계층과 달리, 여기서 기억은 사람이 편집하는 트리이고 변경이 커밋 단위로 남는다. 검색 결과를 돌려주는 데서 끝나지 않고 push/pull로 팀과 기기 사이를 옮긴다. 기억이 특정 에이전트 제품에 묶이지 않는다. Cursor, Claude Code, Windsurf, Cline 같은 도구가 같은 컨텍스트를 읽는다. MCP를 통해 외부 에이전트에 도구와 컨텍스트를 노출한다.

어떻게 쓰나

설치는 npm 전역 설치 또는 셸 스크립트로 한다. 첫 실행 시 REPL이 자동 구성되며 별도 설정이 필요 없다. `/`를 입력하면 사용 가능한 명령 목록이 나온다. `brv webui`는 컨텍스트를 조회·편집하는 웹 대시보드를 띄운다. 클라우드는 `brv login`에 API 키를 넣어 연결하고, 제공자 전환은 `brv providers connect`와 `brv providers switch`로 한다. 하위 디렉터리에서 상위 프로젝트에 붙으려면 `brv worktree add`, 다른 프로젝트 지식을 읽기 전용으로 참조하려면 `brv source`를 쓴다. `brv settings`로 `llm.iterationBudgetMs`와 `llm.requestTimeoutMs`를 조정한다.

전제와 한계

npm 경로는 Node.js 20 이상이 필요하다. 셸 스크립트 설치본의 지원 플랫폼은 macOS ARM64, macOS x64, Linux x64, Linux ARM64로 한정된다. 클라우드 동기화와 팀 기능에는 로그인과 API 키가 있어야 하고, 기본 동작은 전부 로컬이다. `llm.iterationBudgetMs`는 작업 단위로 적용되는 상한이며 기본 10분이고, `llm.requestTimeoutMs`는 그보다 작아야 한다. `brv spaces`는 폐기되었고 기존 sync는 `brv vc push`/`brv vc pull`로 대체되었다.

관련 논문 3

유사 도구