Skip to main content
Use this guide to set up ByteRover V4 for one coding agent. ByteRover V4 has two parts you will use together:
  • ByteRover Desktop manages sign-in, onboarding, spaces, teams, sharing, sync status, and connected agents.
  • ByteRover skill runs inside your coding agent so the agent can query and record project memory.

​
Step 1: Desktop installation

Download and install ByteRover Desktop for your computer. Download ByteRover Desktop Open ByteRover Desktop after installation. On a first run, Desktop shows the ByteRover welcome screen. Select Get started to continue setup.
ByteRover Desktop also registers the byterover:// protocol. This lets browser actions return to the desktop app for sign-in, invitations, billing, and topic links.

​
Step 2: Sign in through the browser

Choose Continue with Google or Continue with GitHub in ByteRover Desktop. ByteRover Desktop sign-in screen Desktop opens the sign-in flow in your browser. Complete the provider sign-in there, then approve the prompt to return to ByteRover Desktop if your browser asks. If Desktop finds an existing ByteRover CLI session, it may also show Continue as your detected account. Use that option only when it is the account you want to use for V4. V4 requires sign-in before you can use Desktop. After sign-in, Desktop continues onboarding and loads your spaces, teams, and connected agents.

​
Step 3: Connect your agent

On first setup, Desktop opens the agent connection step. Connect the coding agent you use for development. Desktop shows each supported agent with one of these actions:
  • Connect installs the ByteRover skill for that agent.
  • Connected means the skill is already installed.
  • Update reinstalls the latest bundled skill when Desktop finds an older copy.
  • Install Guide means the agent needs a manual setup flow.
Connect ByteRover to supported coding agents After you connect at least one agent, select Continue in Desktop. For VPS CLI agents or manual skill installs, run the install command in the same environment where the agent runs: 
npx skills add campfirein/skills
Restart the agent after connecting it. Agents load the ByteRover skill at startup.

​
Step 4: Onboard with ByteRover

Open your coding agent in the project you want to work on. Use the onboarding prompt shown by Desktop, or send: 
onboard with byterover
If Desktop copied Start ByteRover onboarding for you, paste that prompt. It starts the same onboarding flow. The agent will check whether ByteRover is ready for that project.
  • If a space is already available, the agent connects to it and confirms setup.
  • If no space is available, open ByteRover Desktop, create or select a space for the project, then run the prompt again.
  • If the agent needs authentication, it will give you a browser URL. Open the URL, approve the request, then return to the agent and say approved.
After onboarding, ask the agent to check ByteRover before doing real work: 
query byterover for this project
The agent should use ByteRover automatically after setup:
  • query project memory before non-trivial work
  • record useful project knowledge after work is complete

​
Next steps

  • Connect Agent - manage agent connections from Desktop.
  • Team - invite teammates and manage team roles.
  • Space - control where project memory lives and who can access it.
  • Agents - connect OpenClaw, Hermes, Codex CLI, Claude Code, and OpenCode CLI.
  • Bind - connect a project folder to the right ByteRover space.
  • Record - save durable project knowledge after work is complete.
  • Query - retrieve project memory before work starts.
  • Dream - review cleanup and consolidation proposals for saved memory.
  • Auth - approve skill authentication when an agent asks for it.