Skip to main content
Use the Auth skill when your agent says ByteRover needs authentication or cloud sync access for the current workspace. Most users sign in through ByteRover Desktop during setup. Auth is the agent-side approval flow: the agent prints a browser URL and short code, you approve it, then the agent confirms the connection.

​
Ask the agent to authenticate

Ask your agent: 
Authenticate with ByteRover.
The agent starts the ByteRover auth flow. Manual reference: 
node scripts/auth.mjs

​
Open the URL

The agent will print a browser URL, a short code, and an expiry time. Open the URL in your browser and approve the request before the code expires.
Use the URL and code printed by your own agent session. Do not copy a code from docs, screenshots, or another terminal.

​
Return to the agent

After approving in the browser, return to the agent and say: 
approved
The agent checks the auth status. Manual reference: 
node scripts/auth.mjs status

​
Understand the status

StatusMeaningWhat to do
approvedByteRover is connected.Continue setup or retry the original Query or Record request.
pendingThe browser approval is not finished yet.Open the URL again, approve it, then return and say approved.
expiredThe code expired.Start Auth again for a fresh URL and code.
deniedThe browser request was rejected.Start Auth again only if you want to connect this agent.

​
Sign out

Ask the agent: 
Log out of ByteRover.
Manual reference: 
node scripts/logout.mjs

​
Check sync status

If cloud sync seems stuck, ask the agent to check ByteRover sync status. Manual reference: 
node scripts/sync.mjs status
If the status says auth-expired, run Auth again. Never paste API keys into chat to work around an auth problem.