byterover-cli

library3.8.3jsnpmunverified

ByteRover CLI (brv) is an AI-powered context memory tool for developers. It provides a REPL interface and web dashboard for curating project knowledge into a persistent context tree, with version control, cloud sync, and MCP integration. The current stable version is 3.8.3, released with frequent minor releases (every few weeks). It bundles 18 LLM providers and 24 built-in agent tools. Unlike simple note-taking tools, ByteRover offers agentic codebase mapping, git-like versioning for context, and native connectors for 22+ AI coding agents. It ships with TypeScript types and has a bundled installer that does not require Node.js.

llm-agents devops workflow

npm install byterover-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BYTEROVER-CLI

byterover-cli

llm-agentsjavascriptv3.8.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (brv CLI)

✓ npm install -g byterover-cli

✗ npm install byterover-cli (local install, CLI won't be in PATH)

Install globally or use npx byterover-cli for one-off runs.

TypeScript types

✓ import { ByteRoverConfig } from 'byterover-cli'

Types are shipped with the package; available when installed locally.

MCP tools

✓ Use brv mcp or brv connectors to expose as MCP server.

✗ require('byterover-cli') (not a library)

The package is primarily a CLI, not a library. MCP integration is done via CLI commands.

Installs ByteRover CLI (bundled, no Node.js needed), starts the REPL in a project directory, and demonstrates curating knowledge and querying it.

curl -fsSL https://byterover.dev/install.sh | sh cd your/project brv / /curate "Authentication uses JWT with 24h expiry" @src/middleware/auth.ts /query How is authentication implemented?

brv --version

Debug

Known issues

gotchanpm installed version requires Node.js >= 20.0.0

fix

Use the shell script installer which bundles Node.js, or upgrade Node.js to >=20.

affects: >=3.0.0

deprecatedbrv login --api-key <key> is deprecated; use brv login and allow browser sign-in.

fix

Run brv login without flags; use --api-key only on CI or non-interactive shells.

affects: >=3.8.3

gotchaBinary install (script) may fail on older macOS/Linux without curl or sh.

fix

Install via npm: npm install -g byterover-cli (requires Node.js >=20).

affects: all

gotchabrv webui may fail to render correctly if CLI is installed under a hidden folder like ~/.nvm or ~/.asdf. Fixed in v3.8.3.

fix

Upgrade to v3.8.3 or later.

affects: <3.8.3

breakingbrv curate now waits for work to finish by default (v3.8.0+). Scripts relying on async behavior may block indefinitely.

fix

Use brv curate --async to restore non-blocking behavior.

affects: >=3.8.0

Errors

Common errors & fixes

Error: Unsupported platform: darwin-x64 (or similar) during install.sh

The shell script installer did not support Intel Macs before v3.7.0.

fix

Upgrade to v3.7.0+ or use npm install -g byterover-cli.

Error: Cannot find module 'byterover-cli' or 'brv: command not found'

Package not installed globally or not in PATH.

fix

Run npm install -g byterover-cli and ensure npm global bin directory is in PATH.

brv webui shows unstyled dialogs and missing borders (v3.8.0, v3.8.1)

CSS assets not built correctly with release pipeline.

fix

Upgrade to v3.8.2 or later.

Error: Node.js version must be >=20.0.0

Installed via npm on an older Node.js version.

fix

Upgrade Node.js to v20+ or use shell script installer (bundles Node.js).

Upgrade

Version history

3.8.3latest on npm

Audit

Dependencies

nodeoptionalRuntime required for npm installation; bundled version available via shell script

Agent activity

41 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/campfirein/byterover-cli ↗

packagehttps://www.npmjs.com/package/byterover-cli ↗

homepagehttps://byterover.dev ↗