Cipher Files

This release brings multi-repo knowledge sharing to brv. You can now run brv from monorepo subdirectories and sibling checkouts without spawning a second .brv/, pull context from other projects as read-only knowledge sources, and see everything the resolver figured out at a glance from brv status. The tagline: one project's knowledge, any worktree's workflow.

🌟 Highlights

🌳 Git-style worktree links

brv worktree add [path] registers a subdirectory or sibling checkout as a worktree of a parent project by dropping a .brv pointer file (not a directory) that redirects to the parent - the same trick git worktree uses with .git. Run it from inside the subdirectory with no args to auto-detect, list worktrees with brv worktree list, and unregister with brv worktree remove. If the target already has an auto-init'd .brv/, --force backs it up to .brv-backup/ and remove restores it. Also available as /worktree in the REPL.

🔗 Cross-project knowledge sources

brv source add <path> [--alias <name>] links another project's context tree as a read-only knowledge source. Query results pulled from a source are tagged with a shared origin and the source alias, so you can always tell which project an answer came from. A three-layer write guard blocks curate and file writes from leaking into someone else's context tree. Manage sources with brv source list / brv source remove, or /source from the REPL.

🧭 Resolver-aware brv status + workspace-scoped curate/query

brv status now surfaces the resolved project root, the linked worktree root (when different), knowledge-source validity, and actionable warnings for broken or malformed pointers. --verbose shows the resolution source (direct / linked / flag), and a new --project-root <path> flag lets you override auto-detection and fail loudly when the target isn't a ByteRover project. brv curate and brv query automatically pass the worktree root to the daemon when invoked inside a linked worktree - your shell-relative paths still resolve from cwd, so muscle memory keeps working.

What's Changed

✨ Features

• Workspace linking, knowledge sources, and git-style worktree model by @wzlng in [#350]

📚 Docs & Chores

• Updated CHANGELOG.md and CLAUDE.md for the 3.2.0 release by @bao-byterover
• Added null/undefined handling guidance to the CLAUDE.md TypeScript section by @leehpham

🙏 Contributors

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

After upgrading, run brv restart to reload the daemon.

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