Skip to main content
Glama
deenesjakoruzh
campfirein

RyanNg

by campfirein
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

ByteRover CLI

概述

ByteRover CLI (brv) 为 AI 编码代理提供持久化、结构化的内存。它允许开发者将项目知识整理成上下文树，同步到云端，并在不同工具和团队成员之间共享。

在任何项目目录中运行 brv 即可启动由您选择的 LLM 驱动的交互式 REPL。该代理通过代理映射理解您的代码库，可以读取和写入文件、执行代码，并为未来的会话存储知识。

📄 阅读 论文 以获取完整的技术细节。

或者在此处下载我们自托管的 PDF 版本论文 here。

主要功能：

  • 🌐 用于整理和查询上下文的 Web 仪表板 (brv webui)

  • 🖥️ 带有 REPL 接口的交互式 TUI (React/Ink)

  • 🧠 上下文树和知识存储管理

  • 🔀 类似 Git 的上下文树版本控制（分支、提交、合并、推送/拉取）

  • 🤖 18 种 LLM 提供商（Anthropic、OpenAI、Google、Groq、Mistral、xAI 等）

  • 🛠️ 24 种内置代理工具（代码执行、文件操作、知识搜索、内存管理）

  • 🔄 支持推送/拉取的云同步

  • 👀 用于整理操作的审查工作流（批准/拒绝待处理的更改）

  • 🔌 MCP (模型上下文协议) 集成

  • 📦 用于技能和捆绑包的 Hub 和连接器生态系统

  • 🤝 适用于 22+ 种 AI 编码代理（Cursor、Claude Code、Windsurf、Cline 等）

  • 🏢 企业代理支持

Related MCP server: Unicode Puzzles MCP

基准测试结果

所有基准测试均使用本仓库中的生产环境 byterover-cli 代码库运行 - 无需单独的研究原型。

我们在两个长期对话内存基准测试上进行了评估：

  • LoCoMo - 超长对话（约 20K token，35 个会话），测试单跳、多跳、时间性和开放域检索。

  • LongMemEval-S - 大规模基准测试（23,867 个文档，每个问题约 48 个会话），测试包括知识更新、时间推理和多会话合成在内的 6 种内存能力。

LoCoMo - 96.1% 的总体准确率（1,982 个问题，272 个文档）。

LongMemEval-S - 92.8% 的总体准确率（500 个问题，23,867 个文档）。

所有指标均为 LLM-as-Judge 准确率 (%)。请参阅 论文 或自托管 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 云

ByteRover 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

Hub 与连接器

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。

提供商

描述

Anthropic

Claude 模型

OpenAI

GPT 模型

Google

Gemini 模型

Groq

快速推理

Mistral

Mistral 模型

xAI

Grok 模型

Cerebras

快速推理

Cohere

Command 模型

DeepInfra

开源模型托管

OpenRouter

多提供商网关

Perplexity

搜索增强模型

TogetherAI

开源模型托管

Vercel

AI SDK 提供商

Minimax

Minimax 模型

Moonshot

Kimi 模型

GLM

GLM 模型

OpenAI-Compatible

任何兼容 OpenAI 的 API

ByteRover

ByteRover 托管模型

工作树与知识源

词汇表

  • 工作树链接 (Worktree link) — 指向父项目的子目录指针 (brv worktree)

  • 源 (Source) — 对另一个项目知识的只读引用 (brv source)

  • 来源 (Origin) — 索引搜索结果的来源 (local vs shared)

ByteRover 可以在不创建嵌套 .brv/ 的情况下从链接的子目录运行。

  • projectRoot: 拥有 .brv/config.json 的目录

  • worktreeRoot: 链接的工作树目录，或未链接时的 projectRoot

  • clientCwd: 您运行 brv 的 shell 当前工作目录

当您从链接的工作树运行 brv query 或 brv curate 时，隐式默认值使用 worktreeRoot，因此即使 clientCwd 深入到包中，作用域也能保持稳定。您自己传递的显式相对路径（例如 brv curate -f ./src/auth.ts）仍然从 clientCwd 解析，以匹配正常的 shell 行为。

从项目根目录使用 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 获取关于设置、集成和高级用法的完整指南。

主题

描述

入门指南

安装、首次运行和基本用法

云同步

推送/拉取工作流和团队共享

版本控制

上下文树分支、提交和协作

LLM 提供商

提供商设置和模型配置

AI 代理集成

将 ByteRover 与 Cursor、Claude Code、Windsurf 等配合使用

Hub 与连接器

技能、捆绑包和连接器生态系统

CLI 参考

运行 brv --help

贡献

我们欢迎贡献！请参阅我们的 贡献指南 以了解开发设置、编码标准和 PR 工作流。

社区与支持

ByteRover CLI 由 ByteRover 团队 构建和维护。

  • 加入我们的 Discord 分享项目、提问或打个招呼

  • 在 GitHub 上 报告问题

  • 如果您喜欢 ByteRover CLI，请在 GitHub 上给我们点个星标 — 这对我们帮助很大！

  • 在 X 上关注 @kevinnguyendn

贡献者

Contributors

星标历史

许可证

Elastic License 2.0。请参阅 LICENSE 获取完整条款。

This server cannot be installed

A
license - permissive license
-
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
3hResponse time
1dRelease cycle
19Releases (12mo)
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/campfirein/byterover-cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server