Skip to main content

Overview

ByteRover V3 introduces a new CLI-based architecture that replaces the V2 MCP server approach. This guide provides essential information about the transition from V2’s MCP tools to V3’s interactive CLI and context tree system.
V2 MCP Server Deprecation Timeline
  • December 16, 2025: First data migration announcement and registration on Byterover Workspace
  • December 28, 2025: V3 CLI released to production
  • January 25, 2026: V2 memory creation disabled, migration begins for registered users

What’s Changing

FeatureV2 (Deprecated)V3 (Current)
InterfaceMCP server toolsInteractive CLI REPL
StorageCloud-onlyLocal context tree + Cloud sync
Primary Commands (Tools)byterover-store-knowledge
byterover-retrieve-knowledge
/curate
/query
SetupMCP server configurationCLI installation
Connectionhttps://mcp.byterover.dev/v2/mcpLocal CLI + API
Context ManagementAutomatic via agentManual + automatic workflows

Key Benefits of V3

Local Context Tree

Organize knowledge in a structured local workspace with domain-specific folders

Interactive REPL

Direct control over context management through an intuitive command-line interface

Team Collaboration

Push/pull context changes with version control-like workflows

Flexible Workflows

Choose between manual curation and automatic agent-driven workflows

Agent-Specific MCP Deprecation Guides

Detailed instructions for your specific coding agent to remove the old Byterover MCP configuration (V2):

AI-Powered IDEs

Command Line Tools

VS Code Extensions

Desktop & Web Apps

Getting Help

FAQ

ByteRover will provide automatic migration for registered users starting 25, 2026.
Yes, but during data migration, only byterover-retrieve-knowledge is available, knowledge addition is halted for migration. But we recommend completing migration quickly to avoid confusion. V2 and V3 use separate storage systems.
The process is straightforward - we’ve provided agent-specific guides in the migration section above to help you remove V2 MCP configurations from your coding tools.

Ready to go CLI? Start with the V3 Quickstart Guide for detailed CLI setup instructions.