This release includes breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+7 more
Affected surfaces
Summary
AI summaryUser‑configurable runtime knobs via the new brv settings command are added.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| 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 settingslists 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 30mor1h 30m). Values persist at<BRV_DATA_DIR>/settings.jsonand can be browsed from the Configuration page inbrv webui. Runbrv restartafter a change. By @bao-byterover in #673 - Folder metadata in
brv webuiContexts. 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 webuireorganized. 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 --timeoutflag is deprecated. Passing--timeouton commands that accepted it now logs a one-line deprecation notice and has no effect. Usebrv settings set llm.iterationBudgetMs <duration>(e.g.30m,1h, or raw ms) to change the LLM iteration budget instead, then runbrv 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
About byterover-cli
ByteRover CLI (brv) - The portable memory layer for autonomous coding agents (formerly Cipher)
Related context
Beta — feedback welcome: [email protected]