ByteRover CLI

Обзор

ByteRover CLI (brv) предоставляет ИИ-агентам для написания кода постоянную структурированную память. Он позволяет разработчикам систематизировать знания о проекте в виде дерева контекста, синхронизировать их с облаком и делиться ими между инструментами и коллегами.

Запустите brv в любой директории проекта, чтобы начать интерактивный REPL, работающий на выбранной вами LLM. Агент понимает вашу кодовую базу с помощью агентской карты, может читать и записывать файлы, выполнять код и сохранять знания для будущих сессий.

📄 Прочитайте статью для получения полных технических подробностей.

Или скачайте нашу self-hosted PDF-версию статьи здесь.

Ключевые особенности:

• 🌐 Веб-панель для курирования и запросов к контексту (brv webui)

• 🖥️ Интерактивный TUI с интерфейсом REPL (React/Ink)

• 🧠 Управление деревом контекста и хранилищем знаний

• 🔀 Git-подобный контроль версий для дерева контекста (ветки, коммиты, слияние, push/pull)

• 🤖 18 провайдеров LLM (Anthropic, OpenAI, Google, Groq, Mistral, xAI и другие)

• 🛠️ 24 встроенных агентских инструмента (выполнение кода, операции с файлами, поиск знаний, управление памятью)

• 🔄 Облачная синхронизация с push/pull

• 👀 Рабочий процесс проверки для операций курирования (одобрение/отклонение ожидающих изменений)

• 🔌 Интеграция с MCP (Model Context Protocol)

• 📦 Экосистема хабов и коннекторов для навыков и пакетов

• 🤝 Работает с 22+ ИИ-агентами для написания кода (Cursor, Claude Code, Windsurf, Cline и другие)

• 🏢 Поддержка корпоративных прокси

Related MCP server: Unicode Puzzles MCP

Результаты бенчмарков

Все бенчмарки запущены с использованием производственной кодовой базы byterover-cli в этом репозитории — без использования отдельных исследовательских прототипов.

Мы проводим оценку по двум бенчмаркам долгосрочной разговорной памяти:

• LoCoMo — ультрадлинные диалоги (~20 тыс. токенов, 35 сессий), тестирующие одношаговое, многошаговое, временное и открытое извлечение данных.

• LongMemEval-S — крупномасштабный бенчмарк (23 867 документов, ~48 сессий на вопрос), тестирующий 6 способностей памяти, включая обновление знаний, временное рассуждение и синтез нескольких сессий.

LoCoMo — 96,1% общая точность (1 982 вопроса, 272 документа).

LongMemEval-S — 92,8% общая точность (500 вопросов, 23 867 документов).

Все метрики основаны на точности LLM-as-Judge (%). См. статью или self-hosted PDF для получения полной информации.

Быстрый старт

Shell-скрипт (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 — это хостинговая платформа для команд, позволяющая синхронизировать, делиться и управлять контекстными знаниями между проектами и машинами. По умолчанию всё работает локально — облако добавляет возможности совместной работы и постоянства, не меняя ваш рабочий процесс.

Войдите через панель управления или выполните brv login с API-ключом.

• 🔄 Синхронизация контекста команды — push и pull общих знаний между коллегами

• 📂 Общие пространства — организация контекста по нескольким проектам и командам

• 💻 Доступ с нескольких машин — синхронизация дерева контекста между устройствами с облачным бэкапом

• 🧠 Встроенная хостинговая 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.

Рабочие деревья (Worktrees) и источники знаний

Терминология

• Ссылка на рабочее дерево (Worktree link) — указатель поддиректории на родительский проект (brv worktree)

• Источник (Source) — ссылка «только для чтения» на знания другого проекта (brv source)

• Происхождение (Origin) — откуда пришел результат индексированного поиска (local или shared)

ByteRover может работать из связанной поддиректории без создания вложенной .brv/.

• projectRoot: директория, в которой находится .brv/config.json

• worktreeRoot: связанная директория рабочего дерева или projectRoot, если она не связана

• clientCwd: текущая рабочая директория оболочки, из которой вы запустили brv

Когда вы запускаете brv query или brv curate из связанного рабочего дерева, неявные значения по умолчанию используют worktreeRoot, поэтому область видимости остается стабильной, даже если clientCwd уходит глубже в пакет. Явные относительные пути, которые вы передаете сами, например brv curate -f ./src/auth.ts, по-прежнему разрешаются из clientCwd, чтобы соответствовать обычному поведению оболочки.

Используйте brv worktree add из корня проекта, чтобы зарегистрировать поддиректорию (или соседнюю) как рабочее дерево. Это создает файл-указатель .brv в целевой директории, который перенаправляет на родительский проект — тот же паттерн, который git использует для 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 — это очень помогает!

• Подписывайтесь на @kevinnguyendn в X

Участники

История звезд

Лицензия

Elastic License 2.0. См. LICENSE для получения полных условий.