ByteRover CLI

개요

ByteRover CLI(brv)는 AI 코딩 에이전트에게 지속적이고 구조화된 메모리를 제공합니다. 개발자는 프로젝트 지식을 컨텍스트 트리로 구성하고, 클라우드에 동기화하며, 도구 및 팀원 간에 공유할 수 있습니다.

모든 프로젝트 디렉토리에서 brv를 실행하여 원하는 LLM으로 구동되는 대화형 REPL을 시작하세요. 에이전트는 에이전트 맵을 통해 코드베이스를 이해하고, 파일을 읽고 쓰며, 코드를 실행하고, 향후 세션을 위해 지식을 저장할 수 있습니다.

📄 전체 기술 세부 정보는 논문을 읽어보세요.

또는 여기에서 자체 호스팅된 PDF 버전의 논문을 다운로드할 수 있습니다.

주요 기능:

• 🌐 컨텍스트 구성 및 쿼리를 위한 웹 대시보드 (brv webui)

• 🖥️ REPL 인터페이스가 포함된 대화형 TUI (React/Ink)

• 🧠 컨텍스트 트리 및 지식 저장소 관리

• 🔀 컨텍스트 트리를 위한 Git 스타일 버전 제어 (브랜치, 커밋, 병합, 푸시/풀)

• 🤖 18개 LLM 제공업체 (Anthropic, OpenAI, Google, Groq, Mistral, xAI 등)

• 🛠️ 24개 내장 에이전트 도구 (코드 실행, 파일 작업, 지식 검색, 메모리 관리)

• 🔄 푸시/풀을 통한 클라우드 동기화

• 👀 큐레이션 작업을 위한 검토 워크플로우 (보류 중인 변경 사항 승인/거부)

• 🔌 MCP (Model Context Protocol) 통합

• 📦 기술 및 번들을 위한 허브 및 커넥터 생태계

• 🤝 22개 이상의 AI 코딩 에이전트와 호환 (Cursor, Claude Code, Windsurf, Cline 등)

• 🏢 엔터프라이즈 프록시 지원

Related MCP server: Unicode Puzzles MCP

벤치마크 결과

모든 벤치마크는 이 저장소의 프로덕션 byterover-cli 코드베이스를 사용하여 실행되었으며, 별도의 연구용 프로토타입은 사용하지 않았습니다.

우리는 두 가지 장기 대화형 메모리 벤치마크를 평가합니다:

• LoCoMo - 단일 홉, 다중 홉, 시간적 및 오픈 도메인 검색을 테스트하는 초장기 대화 (~20K 토큰, 35개 세션).

• LongMemEval-S - 지식 업데이트, 시간적 추론 및 다중 세션 합성을 포함한 6가지 메모리 능력을 테스트하는 대규모 벤치마크 (23,867개 문서, 질문당 ~48개 세션).

LoCoMo - 96.1% 전체 정확도 (1,982개 질문, 272개 문서).

LongMemEval-S - 92.8% 전체 정확도 (500개 질문, 23,867개 문서).

모든 지표는 LLM-as-Judge 정확도(%)입니다. 자세한 내용은 논문 또는 자체 호스팅 PDF를 참조하세요.

빠른 시작

셸 스크립트 (macOS 및 Linux)

Node.js가 필요하지 않습니다 - 모든 것이 번들로 제공됩니다.

curl -fsSL https://byterover.dev/install.sh | sh

지원 플랫폼: macOS ARM64, macOS x64 (Intel), Linux x64, Linux ARM64.

npm (모든 플랫폼)

Node.js >= 20이 필요합니다.

npm install -g byterover-cli

확인

brv --version

첫 실행

cd your/project
brv

REPL은 첫 실행 시 자동으로 구성되므로 설정이 필요하지 않습니다. /를 입력하여 사용 가능한 모든 명령을 확인하세요:

/curate "Auth uses JWT with 24h expiry" @src/middleware/auth.ts
/query How is authentication implemented?

ByteRover Cloud

ByteRover Cloud는 팀이 프로젝트와 기기 전반에서 컨텍스트 지식을 동기화, 공유 및 관리할 수 있는 호스팅 플랫폼입니다. 기본적으로 모든 것이 로컬에서 작동하며, 클라우드는 워크플로우를 변경하지 않고 협업 및 지속성을 추가합니다.

대시보드에서 로그인하거나 API 키를 사용하여 brv login을 실행하세요.

• 🔄 팀 컨텍스트 동기화 — 팀원 간에 공유 지식을 푸시 및 풀

• 📂 공유 공간 — 여러 프로젝트 및 팀 전반에서 컨텍스트 구성

• 💻 다중 기기 액세스 — 클라우드 백업을 통해 기기 간 컨텍스트 트리 동기화

• 💻 다중 기기 액세스 — 기기 간 컨텍스트 트리 동기화

• 🧠 내장 호스팅 LLM — 제한된 무료 사용량으로 즉시 시작

• 👥 팀 관리 — 웹 앱을 통해 멤버, 공간 및 권한 관리

• 📊 사용량 분석 — 좌석 할당 및 월간 크레딧 소비 추적

• 🔒 SOC 2 Type II 인증 인프라 및 개인정보 보호 모드

대부분의 사용자는 brv webui만 필요합니다. 아래 명령은 고급 사용자 및 자동화를 위한 것입니다. 전체 최신 참조를 보려면 brv --help를 실행하세요.

핵심 워크플로우

brv                  # Start interactive REPL
brv webui            # Open the ByteRover dashboard (primary UI)
brv status           # Show project and daemon status
brv curate           # Add context to knowledge storage
brv curate view      # View curate history
brv query            # Query context tree and knowledge
brv review pending   # List pending review operations
brv review approve   # Approve curate operations
brv review reject    # Reject curate operations

동기화 (레거시)

brv push             # Legacy — migrate or snapshot context to cloud
brv pull             # Legacy — restore context from cloud snapshot

향후 버전 제어 동기화를 위해 brv vc push / brv vc pull을 사용하세요.

버전 제어

brv vc init              # Initialize version control for context tree
brv vc status            # Show version control status
brv vc add               # Stage files for the next commit
brv vc commit            # Save staged changes as a commit
brv vc log               # Show commit history
brv vc branch            # List, create, or delete branches
brv vc checkout          # Switch branches
brv vc merge             # Merge a branch into the current branch
brv vc clone             # Clone a ByteRover space repository
brv vc push              # Push commits to ByteRover cloud
brv vc pull              # Pull commits from ByteRover cloud
brv vc fetch             # Fetch refs from ByteRover cloud
brv vc remote            # Show current remote origin
brv vc remote add        # Add a named remote
brv vc remote set-url    # Update a remote URL
brv vc config            # Get or set commit author
brv vc reset             # Unstage files or undo commits

제공업체 및 모델

brv providers list       # List available LLM providers
brv providers connect    # Connect to an LLM provider
brv providers switch     # Switch active provider
brv providers disconnect # Disconnect a provider
brv model list           # List available models
brv model switch         # Switch active model

허브 및 커넥터

brv hub list             # List available hub packages
brv hub install          # Install a hub package
brv hub registry add     # Add a custom registry
brv hub registry list    # List registries
brv hub registry remove  # Remove a registry
brv connectors list      # List connectors
brv connectors install   # Install a connector

공간 (사용 중단)

brv space list       # Deprecated — use web dashboard
brv space switch     # Deprecated — use brv vc clone

기타

brv mcp              # Start MCP server
brv login            # Authenticate to ByteRover
brv logout           # Disconnect and clear credentials
brv locations        # List registered projects
brv restart          # Restart daemon
brv debug            # Debug mode

전체 명령 참조를 보려면 brv --help를 실행하세요.

ByteRover CLI는 18개의 LLM 제공업체를 즉시 지원합니다. 대시보드에서 제공업체를 연결 및 전환하거나 brv providers connect / brv providers switch를 사용하세요.

워크트리 및 지식 소스

용어

• 워크트리 링크 — 상위 프로젝트에 대한 하위 디렉토리 포인터 (brv worktree)

• 소스 — 다른 프로젝트 지식에 대한 읽기 전용 참조 (brv source)

• 오리진 — 인덱싱된 검색 결과의 출처 (local 대 shared)

ByteRover는 중첩된 .brv/를 생성하지 않고도 연결된 하위 디렉토리에서 실행될 수 있습니다.

• projectRoot: .brv/config.json을 소유한 디렉토리

• worktreeRoot: 연결된 워크트리 디렉토리, 또는 연결 해제 시 projectRoot

• clientCwd: brv를 실행한 셸의 현재 작업 디렉토리(cwd)

연결된 워크트리에서 brv query 또는 brv curate를 실행하면, clientCwd가 패키지 내부로 더 깊이 들어가더라도 범위가 안정적으로 유지되도록 암시적 기본값이 worktreeRoot를 사용합니다. brv curate -f ./src/auth.ts와 같이 직접 전달하는 명시적 상대 경로는 일반적인 셸 동작과 일치하도록 clientCwd에서 해결됩니다.

프로젝트 루트에서 brv worktree add를 사용하여 하위 디렉토리(또는 형제 디렉토리)를 워크트리로 등록하세요. 이는 대상 디렉토리에 상위 프로젝트로 리디렉션되는 .brv 포인터 파일을 생성합니다. 이는 git worktree에 사용되는 패턴과 동일합니다. 등록을 취소하려면 brv worktree remove를, 검사하려면 brv worktree list를 사용하세요. 여기에서 다른 프로젝트의 지식을 검색하려면 brv source add <path>를 사용하세요 (검사 또는 분리하려면 brv source list / brv source remove 사용).

문서

설정, 통합 및 고급 사용법에 대한 전체 가이드는 docs.byterover.dev를 방문하세요.

기여

기여를 환영합니다! 개발 설정, 코딩 표준 및 PR 워크플로우는 기여 가이드를 참조하세요.

커뮤니티 및 지원

ByteRover CLI는 ByteRover 팀이 구축하고 유지 관리합니다.

• Discord에 가입하여 프로젝트를 공유하거나, 질문하거나, 인사하세요.

• GitHub에서 이슈 보고를 하세요.

• ByteRover CLI가 마음에 드신다면 GitHub에서 별을 눌러주세요. 큰 도움이 됩니다!

• X에서 @kevinnguyendn을 팔로우하세요.

기여자

별 기록

라이선스

Elastic License 2.0. 전체 약관은 LICENSE를 참조하세요.