Cipher Files

This release is all about adaptive knowledge. brv now learns from how its knowledge is actually used — frequently-consulted entries rise in search, large entries are stored as compressed abstracts so they cost fewer tokens to consult, and the agent quietly distills patterns and decisions from each REPL session into durable knowledge. The longer you use it, the sharper it gets.

🌟 Highlights

📈 Adaptive knowledge scoring

The knowledge base now ranks results by usage. A new hotness score combined with hierarchical score propagation surfaces the entries you actually consult, while neglected ones decay out of the way. Search relevance improves automatically as you work.

📝 Knowledge abstracts

Knowledge entries now auto-generate compressed abstracts and overviews, so the agent can reason over a much larger knowledge base without burning the context window.

🧠 Session learning

A new session-learning pass extracts patterns, preferences, decisions, and skills from each REPL session and stores them as durable knowledge for future runs — repeated workflows and project conventions get internalized instead of re-discovered.

📥 Resource ingestion tool

A new agent tool pulls external files and resources directly into your knowledge base from inside the REPL, so you can bring in docs, specs, and reference material without leaving brv.

What's Changed

✨ Features

• Adaptive knowledge scoring, abstracts, session learning, and the resource ingestion tool by @ngduyanhece in [#336]

🐛 Fixes

• Fixed double compound scoring in parent score propagation, tightened maturity filtering, and corrected result truncation in knowledge search by @ngduyanhece in [#336]
• Clean oclif client cache in install/uninstall scripts to prevent stale-cache issues after upgrades by @bao-byterover in [#345]

📚 Docs & Chores

• Updated CHANGELOG.md and CLAUDE.md for the 3.1.0 release by @bao-byterover

🙏 Contributors

Thanks to everyone who shipped this release: @ngduyanhece, @bao-byterover, @RyanNg1403, and @leehpham.

Upgrade

:::bash
# npm
npm uninstall -g byterover-cli
npm i -g byterover-cli

# native binary (macOS / Linux)
curl -fsSL https://byterover.dev/uninstall.sh | sh
curl -fsSL https://byterover.dev/install.sh | sh

After upgrading, run brv restart to reload the daemon.

Full Changelog: https://github.com/campfirein/byterover-cli/compare/v3.0.1...v3.1.0