ByteRover CLI

概要

ByteRover CLI (brv) は、AIコーディングエージェントに永続的で構造化されたメモリを提供します。開発者はプロジェクトの知識をコンテキストツリーに整理し、クラウドに同期して、ツールやチームメンバー間で共有することができます。

任意のプロジェクトディレクトリで brv を実行すると、選択したLLMを利用したインタラクティブなREPLが起動します。エージェントはエージェントマップを通じてコードベースを理解し、ファイルの読み書き、コードの実行、そして将来のセッションのために知識を保存することができます。

📄 技術的な詳細については、論文 をお読みください。

または、論文のセルフホスト版PDFを こちら からダウンロードしてください。

主な機能:

• 🌐 コンテキストを整理・クエリするためのWebダッシュボード (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 コードベースを使用して実行されており、個別の研究用プロトタイプではありません。

私たちは2つの長期会話メモリベンチマークで評価を行っています:

• LoCoMo - 超長期会話 (~20Kトークン、35セッション) で、シングルホップ、マルチホップ、時間的、およびオープンドメインの検索をテストします。

• LongMemEval-S - 大規模ベンチマーク (23,867ドキュメント、質問あたり約48セッション) で、知識更新、時間的推論、マルチセッション合成を含む6つのメモリ能力をテストします。

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は、チームがプロジェクトやマシン間でコンテキスト知識を同期、共有、管理するためのホスト型プラットフォームです。 デフォルトですべてローカルで動作します。Cloudはワークフローを変更することなく、コラボレーションと永続性を追加します。

ダッシュボードからサインインするか、APIキー を使用して brv login を実行してください。

• 🔄 チームコンテキスト同期 — チームメンバー間で共有知識をプッシュおよびプル

• 📂 共有スペース — 複数のプロジェクトやチーム間でコンテキストを整理

• 💻 マルチマシンアクセス — クラウドバックアップを使用してデバイス間でコンテキストツリーを同期

• 💻 マルチマシンアクセス — デバイス間でコンテキストツリーを同期

• 🧠 組み込みホスト型LLM — 無料枠を使用してすぐに開始可能

• 👥 チーム管理 — Webアプリ経由でメンバー、スペース、権限を管理

• 📊 利用状況分析 — シート割り当てと月間クレジット消費を追跡

• 🔒 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 を実行したシェルの現在の作業ディレクトリ

リンクされたワークツリーから brv query や brv curate を実行すると、暗黙のデフォルト設定で worktreeRoot が使用されるため、clientCwd がパッケージの奥深くに移動してもスコープは安定します。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 を参照してください。