{"id":18191,"library":"byterover-cli","title":"ByteRover CLI","description":"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.","status":"active","version":"3.8.3","language":"javascript","source_language":"en","source_url":"https://github.com/campfirein/byterover-cli","tags":["javascript","cli","ai","llm","mcp","developer-tools","context-memory","autonomous-agents","coding-assistant","typescript"],"install":[{"cmd":"npm install byterover-cli","lang":"bash","label":"npm"},{"cmd":"yarn add byterover-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add byterover-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Runtime required for npm installation; bundled version available via shell script","package":"node","optional":true}],"imports":[{"note":"Install globally or use npx byterover-cli for one-off runs.","wrong":"npm install byterover-cli (local install, CLI won't be in PATH)","symbol":"default (brv CLI)","correct":"npm install -g byterover-cli"},{"note":"Types are shipped with the package; available when installed locally.","wrong":"","symbol":"TypeScript types","correct":"import { ByteRoverConfig } from 'byterover-cli'"},{"note":"The package is primarily a CLI, not a library. MCP integration is done via CLI commands.","wrong":"require('byterover-cli') (not a library)","symbol":"MCP tools","correct":"Use brv mcp or brv connectors to expose as MCP server."}],"quickstart":{"code":"curl -fsSL https://byterover.dev/install.sh | sh\ncd your/project\nbrv /\n/curate \"Authentication uses JWT with 24h expiry\" @src/middleware/auth.ts\n/query How is authentication implemented?","lang":"typescript","description":"Installs ByteRover CLI (bundled, no Node.js needed), starts the REPL in a project directory, and demonstrates curating knowledge and querying it."},"warnings":[{"fix":"Use the shell script installer which bundles Node.js, or upgrade Node.js to >=20.","message":"npm installed version requires Node.js >= 20.0.0","severity":"gotcha","affected_versions":">=3.0.0"},{"fix":"Run brv login without flags; use --api-key only on CI or non-interactive shells.","message":"brv login --api-key <key> is deprecated; use brv login and allow browser sign-in.","severity":"deprecated","affected_versions":">=3.8.3"},{"fix":"Install via npm: npm install -g byterover-cli (requires Node.js >=20).","message":"Binary install (script) may fail on older macOS/Linux without curl or sh.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade to v3.8.3 or later.","message":"brv webui may fail to render correctly if CLI is installed under a hidden folder like ~/.nvm or ~/.asdf. Fixed in v3.8.3.","severity":"gotcha","affected_versions":"<3.8.3"},{"fix":"Use brv curate --async to restore non-blocking behavior.","message":"brv curate now waits for work to finish by default (v3.8.0+). Scripts relying on async behavior may block indefinitely.","severity":"breaking","affected_versions":">=3.8.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Upgrade to v3.7.0+ or use npm install -g byterover-cli.","cause":"The shell script installer did not support Intel Macs before v3.7.0.","error":"Error: Unsupported platform: darwin-x64 (or similar) during install.sh"},{"fix":"Run npm install -g byterover-cli and ensure npm global bin directory is in PATH.","cause":"Package not installed globally or not in PATH.","error":"Error: Cannot find module 'byterover-cli' or 'brv: command not found'"},{"fix":"Upgrade to v3.8.2 or later.","cause":"CSS assets not built correctly with release pipeline.","error":"brv webui shows unstyled dialogs and missing borders (v3.8.0, v3.8.1)"},{"fix":"Upgrade Node.js to v20+ or use shell script installer (bundles Node.js).","cause":"Installed via npm on an older Node.js version.","error":"Error: Node.js version must be >=20.0.0"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}