ByteRover's CLI
$git clone https://github.com/campfirein/byterover-cliInstalls into the current project.
Install byterover-cli by running `git clone https://github.com/campfirein/byterover-cli`, then use it for the current task and follow its documentation at https://github.com/campfirein/byterover-cli.
| 1 | # ByteRover CLI |
| 2 | |
| 3 | <div align="center"> |
| 4 | |
| 5 | <img src="./assets/images/logo/byterover-logo.svg" alt="ByteRover Logo" width="280" /> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <em>Interactive REPL CLI for AI-powered context memory</em> |
| 9 | </p> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <a href="LICENSE"><img src="https://img.shields.io/badge/License-Elastic%202.0-blue.svg" alt="License" /></a> |
| 13 | <a href="https://npmjs.org/package/byterover-cli"><img src="https://img.shields.io/npm/v/byterover-cli.svg" alt="Version" /></a> |
| 14 | <a href="https://npmjs.org/package/byterover-cli"><img src="https://img.shields.io/npm/dw/byterover-cli.svg" alt="Downloads" /></a> |
| 15 | <a href="https://docs.byterover.dev"><img src="https://img.shields.io/badge/Docs-Documentation-green.svg" alt="Documentation" /></a> |
| 16 | <a href="https://discord.com/invite/UMRrpNjh5W"><img src="https://img.shields.io/badge/Discord-Join%20Community-7289da" alt="Discord" /></a> |
| 17 | </p> |
| 18 | |
| 19 | </div> |
| 20 | |
| 21 | ## Overview |
| 22 | |
| 23 | ByteRover CLI (`brv`) gives AI coding agents persistent, structured memory. It lets developers curate project knowledge into a context tree, sync it to the cloud, and share it across tools and teammates. |
| 24 | |
| 25 | Run `brv` in any project directory to start an interactive REPL powered by your choice of LLM. The agent understands your codebase through an agentic map, can read and write files, execute code, and store knowledge for future sessions. |
| 26 | |
| 27 | 📄 Read the [paper](https://arxiv.org/abs/2604.01599) for the full technical details. |
| 28 | |
| 29 | Or download our self-hosted PDF version of the paper [here](https://byterover.dev/paper). |
| 30 | |
| 31 | **Key Features:** |
| 32 | |
| 33 | - 🌐 Web dashboard for curating and querying context (`brv webui`) |
| 34 | - 🖥️ Interactive TUI with REPL interface (React/Ink) |
| 35 | - 🧠 Context tree and knowledge storage management |
| 36 | - 🔀 Git-like version control for the context tree (branch, commit, merge, push/pull) |
| 37 | - 🤖 20 LLM providers (Anthropic, OpenAI, Google, Groq, Mistral, xAI, DeepSeek, and more) |
| 38 | - 🛠️ 24 built-in agent tools (code exec, file ops, knowledge search, memory management) |
| 39 | - 🔄 Cloud sync with push/pull |
| 40 | - 👀 Review workflow for curate operations (approve/reject pending changes) |
| 41 | - 🔌 MCP (Model Context Protocol) integration |
| 42 | - 📦 Hub and connectors ecosystem for skills and bundles |
| 43 | - 🤝 Works with 22+ AI coding agents (Cursor, Claude Code, Windsurf, Cline, and more) |
| 44 | - 🏢 Enterprise proxy support |
| 45 | |
| 46 | ## Benchmark Results |
| 47 | |
| 48 | All benchmarks are run using the production `byterover-cli` codebase in this repository - no separate research prototype. |
| 49 | |
| 50 | We evaluate on two long-term conversational memory benchmarks: |
| 51 | |
| 52 | - **LoCoMo** - ultra-long conversations (~20K tokens, 35 sessions) testing single-hop, multi-hop, temporal, and open-domain retrieval. |
| 53 | - **LongMemEval-S** - large-scale benchmark (23,867 docs, ~48 sessions per question) testing 6 memory abilities including knowledge update, temporal reasoning, and multi-session synthesis. |
| 54 | |
| 55 | **LoCoMo** - 96.1% overall accuracy (1,982 questions, 272 docs). |
| 56 | |
| 57 | **LongMemEval-S** - 92.8% overall accuracy (500 questions, 23,867 docs). |
| 58 | |
| 59 | <p align="center"> |
| 60 | <img src="assets/images/benchmarks/longmemeval-s-by-category.png" alt="LongMemEval-S Benchmark by Category" width="700" /> |
| 61 | </p> |
| 62 | |
| 63 | All metrics are LLM-as-Judge accuracy (%). See the [paper](https://arxiv.org/abs/2604.01599), or self-hosted [PDF](https://byterover.dev/paper) for full details. |
| 64 | |
| 65 | ## Quick Start |
| 66 | |
| 67 | ### Shell Script (macOS & Linux) |
| 68 | |
| 69 | No Node.js required - everything is bundled. |
| 70 | |
| 71 | ```bash |
| 72 | curl -fsSL https://byterover.dev/install.sh | sh |
| 73 | ``` |
| 74 | |
| 75 | Supported platforms: macOS ARM64, macOS x64 (Intel), Linux x64, Linux ARM64. |
| 76 | |
| 77 | ### npm (All Platforms) |
| 78 | |
| 79 | Requires Node.js >= 20. |
| 80 | |
| 81 | ```bash |
| 82 | npm install -g byterover-cli |
| 83 | ``` |
| 84 | |
| 85 | ### Verify |
| 86 | |
| 87 | ```bash |
| 88 | brv --version |
| 89 | ``` |
| 90 | |
| 91 | ### First Run |
| 92 | |
| 93 | ```bash |
| 94 | cd your/project |
| 95 | brv |
| 96 | ``` |
| 97 | |
| 98 | The REPL auto-configures on first run - no setup needed. Type `/` to discover all available commands: |
| 99 | |
| 100 | ``` |
| 101 | /curate "Auth uses JWT with 24h expiry" @src/middleware/auth.ts |
| 102 | /query How is authentication implemented? |
| 103 | ``` |
| 104 | |
| 105 | ## ByteRover Cloud |
| 106 | |
| 107 | ByteRover Cloud is a hosted platform for teams to sync, |