Skip to main content
ByteRover CLI runs entirely on your machine with no cloud account required. Cloud features layer on top — adding team sync, multi-machine access, and backup — without changing the core local workflow.

​
Commands: local vs cloud

Commands available in the interactive REPL (brv):
Works locally (no auth)Requires cloud auth
/status — show local project state/login — authenticate with ByteRover
/curate — add context to local knowledge tree/logout — clear authentication
/query — query local context tree/push — sync local context to cloud
/connectors — manage agent connectors/pull — pull context from cloud
/hub — browse and install skills & bundles/space list — list team spaces
/provider — connect and switch LLM providers/space switch — switch active space
/model — select a model
/reset — clear local context tree
/new — start a fresh session

​
Upgrade from local to cloud

1

Authenticate

Run /login inside the REPL to authenticate via browser:
/login
2

Switch to a space

Select a team space. ByteRover updates .brv/config.json and automatically pulls any existing context from the remote space.
/space switch
An interactive picker lists all spaces across your teams. Selecting one switches your project and pulls remote context in a single step.Space switch interactive picker
3

Push local context to cloud

Sync your .brv/context-tree/ to the remote space. Teammates can pull this immediately after.
/push
Push syncing context to cloud
4

Pull on other machines

On any machine where you’re authenticated, run /space switch to select the same space — it automatically pulls remote context. After the initial switch, use /pull to sync subsequent changes from teammates.

​
When to use cloud

Use caseWhy
Team collaborationShare a space with teammates — everyone queries the same knowledge base
Multi-machine syncPush from your laptop, pull on a server or a new machine
BackupPersist your context tree outside the local repo
All local features — curate, query, provider selection, hub, connectors — work without a cloud account and without an internet connection when using a local LLM provider.

​
Next steps

Team Context Sync

Full walkthrough of the shared context workflow for teams

Local Context Tree

Understand the local knowledge store before pushing it to cloud

The Remote Space

How ByteRover processes and organizes context once it’s pushed to the cloud

CLI Reference

Complete flag reference for push, pull, and space commands