Skip to content

byterover-cli

v3.15.0 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 14d AI Coding Tools
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent ai autonomous-agents cli coding-assistant context-memory
+7 more
developer-tools knowledge-management llm mcp memory typescript vibe-coding

Affected surfaces

breaking_upgrade

Summary

AI summary

User‑configurable runtime knobs via the new brv settings command are added.

Changes in this release

Feature Medium

User-configurable settings via `brv settings` command introduced.

User-configurable settings via `brv settings` command introduced.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Feature Medium

`brv webui` Configuration page reorganized into General, Connectors, Version Control sections.

`brv webui` Configuration page reorganized into General, Connectors, Version Control sections.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Feature Medium

Folder metadata now renders in `brv webui` Contexts detail panel.

Folder metadata now renders in `brv webui` Contexts detail panel.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Performance Medium

No performance impact; settings apply after running `brv restart`.

No performance impact; settings apply after running `brv restart`.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: low

Deprecation Medium

`--timeout` flag deprecated; use `llm.iterationBudgetMs` via `brv settings` instead.

`--timeout` flag deprecated; use `llm.iterationBudgetMs` via `brv settings` instead.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Refactor Medium

Values persist at `<BRV_DATA_DIR>/settings.json` and browsable in `brv webui` Configuration page.

Values persist at `<BRV_DATA_DIR>/settings.json` and browsable in `brv webui` Configuration page.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: low

Full changelog

ByteRover CLI 3.15.0 introduces user-configurable settings via the new brv settings command, so you can tune things like agent pool size, concurrent tasks per project, and the LLM iteration budget without editing source or rebuilding. The brv webui Configuration page is reorganized into three sections (General, Connectors, Version Control) to make room for the new controls, folder metadata now renders in the Contexts detail panel, and the --timeout flag is deprecated in favor of llm.iterationBudgetMs set via brv settings.

What's Changed

✨ Added

  • Tune BRV with brv settings. Adjust runtime knobs like agent pool size, concurrent tasks per project, LLM iteration budget, and task-history retention without editing source or rebuilding. brv settings lists every option by category (concurrency, LLM, task history); brv settings get/set/reset <key> operates on a single value. Use plain numbers for count keys (e.g. agentPool.maxSize 25) and duration strings for time keys (e.g. llm.iterationBudgetMs 30m or 1h 30m). Values persist at <BRV_DATA_DIR>/settings.json and can be browsed from the Configuration page in brv webui. Run brv restart after a change. By @bao-byterover in #673
  • Folder metadata in brv webui Contexts. Folders in the context tree now render their title, summary, tags, and related links in the detail panel, the same way files already did. By @ncnthien in #676

🚀 Changed

  • Configuration page in brv webui reorganized. Settings now live under three sections (General, Connectors, Version Control) instead of one long page, so the new agent-pool and task-history controls have room alongside the existing identity, provider, and remote settings. By @bao-byterover in #673
  • --timeout flag is deprecated. Passing --timeout on commands that accepted it now logs a one-line deprecation notice and has no effect. Use brv settings set llm.iterationBudgetMs <duration> (e.g. 30m, 1h, or raw ms) to change the LLM iteration budget instead, then run brv restart. By @bao-byterover in #673

🚀 Upgrade & Install

Fresh install (macOS / Linux):

curl -fsSL https://byterover.dev/install.sh | sh

Existing users: re-run the installer above to upgrade in place, then run brv restart so the daemon picks up the new settings store and the reorganized Configuration page.

✅ No Breaking Changes

All changes are backward compatible. Existing context trees, provider configs, and connected agents continue to work with no migration. The --timeout flag still parses without erroring (commands log a one-line deprecation and ignore the value); migrate scripts that relied on it to brv settings set llm.iterationBudgetMs <duration> followed by brv restart to keep the same effect. New settings keys default to the values previously hard-coded in src/constants.ts, so behavior is unchanged until you opt in by running brv settings set.

🙏 Contributors

Thanks to @bao-byterover and @ncnthien for shipping this release.

Full Changelog: https://github.com/campfirein/byterover-cli/compare/v3.14.0...v3.15.0

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track byterover-cli

Get notified when new releases ship.

Sign up free

About byterover-cli

ByteRover CLI (brv) - The portable memory layer for autonomous coding agents (formerly Cipher)

All releases →

Beta — feedback welcome: [email protected]