ByteRover CLI

Überblick

ByteRover CLI (brv) verleiht KI-Coding-Agents einen persistenten, strukturierten Speicher. Es ermöglicht Entwicklern, Projektwissen in einem Kontextbaum zu kuratieren, in die Cloud zu synchronisieren und über verschiedene Tools und Teammitglieder hinweg zu teilen.

Führen Sie brv in einem beliebigen Projektverzeichnis aus, um eine interaktive REPL zu starten, die von einem LLM Ihrer Wahl betrieben wird. Der Agent versteht Ihre Codebasis durch eine agentische Karte, kann Dateien lesen und schreiben, Code ausführen und Wissen für zukünftige Sitzungen speichern.

📄 Lesen Sie das Paper für alle technischen Details.

Oder laden Sie unsere selbst gehostete PDF-Version des Papers hier herunter.

Hauptfunktionen:

• 🌐 Web-Dashboard zum Kuratieren und Abfragen von Kontext (brv webui)

• 🖥️ Interaktives TUI mit REPL-Schnittstelle (React/Ink)

• 🧠 Verwaltung von Kontextbaum und Wissensspeicher

• 🔀 Git-ähnliche Versionskontrolle für den Kontextbaum (Branch, Commit, Merge, Push/Pull)

• 🤖 18 LLM-Anbieter (Anthropic, OpenAI, Google, Groq, Mistral, xAI und mehr)

• 🛠️ 24 integrierte Agenten-Tools (Code-Ausführung, Dateioperationen, Wissenssuche, Speicherverwaltung)

• 🔄 Cloud-Synchronisierung mit Push/Pull

• 👀 Review-Workflow für Kuratierungsoperationen (ausstehende Änderungen genehmigen/ablehnen)

• 🔌 MCP (Model Context Protocol) Integration

• 📦 Hub- und Connector-Ökosystem für Skills und Bundles

• 🤝 Funktioniert mit über 22 KI-Coding-Agents (Cursor, Claude Code, Windsurf, Cline und mehr)

• 🏢 Unterstützung für Unternehmens-Proxys

Related MCP server: Unicode Puzzles MCP

Benchmark-Ergebnisse

Alle Benchmarks werden mit der produktiven byterover-cli-Codebasis in diesem Repository ausgeführt – kein separates Forschungsprototyp.

Wir evaluieren anhand von zwei Benchmarks für langfristiges Konversationsgedächtnis:

• LoCoMo - extrem lange Konversationen (~20.000 Token, 35 Sitzungen), die Single-Hop-, Multi-Hop-, zeitliche und Open-Domain-Abfragen testen.

• LongMemEval-S - groß angelegter Benchmark (23.867 Dokumente, ~48 Sitzungen pro Frage), der 6 Gedächtnisfähigkeiten testet, einschließlich Wissensaktualisierung, zeitlichem Schlussfolgern und Multi-Sitzungs-Synthese.

LoCoMo - 96,1 % Gesamtgenauigkeit (1.982 Fragen, 272 Dokumente).

LongMemEval-S - 92,8 % Gesamtgenauigkeit (500 Fragen, 23.867 Dokumente).

Alle Metriken sind LLM-as-Judge-Genauigkeiten (%). Siehe das Paper oder das selbst gehostete PDF für vollständige Details.

Schnellstart

Shell-Skript (macOS & Linux)

Kein Node.js erforderlich – alles ist gebündelt.

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

Unterstützte Plattformen: macOS ARM64, macOS x64 (Intel), Linux x64, Linux ARM64.

npm (Alle Plattformen)

Erfordert Node.js >= 20.

npm install -g byterover-cli

Überprüfung

brv --version

Erster Start

cd your/project
brv

Die REPL konfiguriert sich beim ersten Start automatisch – keine Einrichtung erforderlich. Geben Sie / ein, um alle verfügbaren Befehle zu entdecken:

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

ByteRover Cloud

ByteRover Cloud ist eine gehostete Plattform für Teams, um Kontextwissen über Projekte und Maschinen hinweg zu synchronisieren, zu teilen und zu verwalten. Alles funktioniert standardmäßig lokal – Cloud fügt Zusammenarbeit und Persistenz hinzu, ohne Ihren Workflow zu ändern.

Melden Sie sich über das Dashboard an oder führen Sie brv login mit einem API-Schlüssel aus.

• 🔄 Team-Kontext-Synchronisierung — geteiltes Wissen zwischen Teammitgliedern pushen und pullen

• 📂 Geteilte Bereiche — Kontext über mehrere Projekte und Teams hinweg organisieren

• 💻 Multi-Maschinen-Zugriff — synchronisieren Sie Ihren Kontextbaum über Geräte hinweg mit Cloud-Backup

• 🧠 Integriertes gehostetes LLM — starten Sie sofort mit begrenzter kostenloser Nutzung

• 👥 Teamverwaltung — verwalten Sie Mitglieder, Bereiche und Berechtigungen über die Web-App

• 📊 Nutzungsanalysen — verfolgen Sie die Sitzplatzbelegung und den monatlichen Kreditverbrauch

• 🔒 SOC 2 Typ II zertifizierte Infrastruktur mit Datenschutzmodus

Die meisten Benutzer benötigen nur brv webui. Die unten aufgeführten Befehle sind für fortgeschrittene Benutzer und Automatisierung gedacht. Führen Sie brv --help für die vollständige, aktuelle Referenz aus.

Kern-Workflow

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

Synchronisierung (Legacy)

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

Verwenden Sie brv vc push / brv vc pull für versionskontrollierte Synchronisierung in Zukunft.

Versionskontrolle

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

Anbieter & Modelle

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

Hub & Connectors

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

Bereiche (Veraltet)

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

Sonstiges

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

Führen Sie brv --help für die vollständige Befehlsreferenz aus.

ByteRover CLI unterstützt 18 LLM-Anbieter direkt nach der Installation. Verbinden und wechseln Sie Anbieter über das Dashboard oder verwenden Sie brv providers connect / brv providers switch.

Worktrees und Wissensquellen

Vokabular

• Worktree-Link — ein Unterverzeichnis-Zeiger auf ein übergeordnetes Projekt (brv worktree)

• Quelle — eine schreibgeschützte Referenz auf das Wissen eines anderen Projekts (brv source)

• Ursprung — woher ein indiziertes Suchergebnis stammt (local vs shared)

ByteRover kann von einem verknüpften Unterverzeichnis aus ausgeführt werden, ohne ein verschachteltes .brv/ zu erstellen.

• projectRoot: das Verzeichnis, das .brv/config.json besitzt

• worktreeRoot: das verknüpfte Worktree-Verzeichnis oder projectRoot, wenn nicht verknüpft

• clientCwd: das Shell-Arbeitsverzeichnis, in dem Sie brv ausgeführt haben

Wenn Sie brv query oder brv curate von einem verknüpften Worktree ausführen, verwenden implizite Standardwerte worktreeRoot, sodass der Bereich stabil bleibt, selbst wenn clientCwd tiefer in das Paket abdriftet. Explizite relative Pfade, die Sie selbst übergeben, wie brv curate -f ./src/auth.ts, werden weiterhin von clientCwd aus aufgelöst, um dem normalen Shell-Verhalten zu entsprechen.

Verwenden Sie brv worktree add vom Projektstamm aus, um ein Unterverzeichnis (oder Geschwisterverzeichnis) als Worktree zu registrieren. Dies erstellt eine .brv-Zeigerdatei im Zielverzeichnis, die auf das übergeordnete Projekt umleitet – dasselbe Muster, das Git für git worktree verwendet. Verwenden Sie brv worktree remove zum Aufheben der Registrierung und brv worktree list zum Überprüfen. Um von hier aus das Wissen eines anderen Projekts zu durchsuchen, verwenden Sie brv source add <path> (mit brv source list / brv source remove zum Überprüfen oder Trennen).

Dokumentation

Besuchen Sie docs.byterover.dev für vollständige Anleitungen zu Einrichtung, Integrationen und fortgeschrittener Nutzung.

Mitwirken

Wir freuen uns über Beiträge! Siehe unseren Leitfaden für Mitwirkende für die Entwicklungseinrichtung, Codierungsstandards und den PR-Workflow.

Community & Support

ByteRover CLI wird vom ByteRover-Team erstellt und gepflegt.

• Treten Sie unserem Discord bei, um Projekte zu teilen, Fragen zu stellen oder einfach Hallo zu sagen

• Melden Sie Probleme auf GitHub

• Wenn Ihnen ByteRover CLI gefällt, geben Sie uns bitte einen Stern auf GitHub – das hilft sehr!

• Folgen Sie @kevinnguyendn auf X

Mitwirkende

Stern-Verlauf

Lizenz

Elastic License 2.0. Siehe LICENSE für die vollständigen Bedingungen.