Use the Bind skill when a project folder should read and write memory in a specific ByteRover space.
Binding is usually handled during onboarding. Use this page when an agent reports that no space is configured, when the wrong space is selected, or when you want to make a project-to-space relationship explicit.
Before you bind
- Install the ByteRover skill in your agent.
- Sign in to ByteRover Desktop.
- Create or select the space in ByteRover Desktop first.
- Open your agent or terminal from the project root.
The skill does not create spaces. Create the space in ByteRover Desktop, then bind the project folder to it.
Check the current space
Ask your agent:
Check which ByteRover space this project is using.
The agent checks the current folder’s space resolution.
Manual reference:
node scripts/space.mjs current
Bind the project to a space
Ask your agent:
Bind this project to the "<space name>" ByteRover space.
Replace <space name> with the exact space name from ByteRover Desktop.
Manual reference:
node scripts/space.mjs bind "My Project"
Binding stores a local project binding so future Query and Record calls resolve to that space from the project folder.
Verify the binding
Ask your agent:
Check ByteRover space again and confirm this project is bound correctly.
Manual reference:
node scripts/space.mjs current
The result should point to the intended space.
Common fixes
| Problem | What to do |
|---|
| Space not found | Create the space in ByteRover Desktop, then run bind again with the exact name. |
| Wrong space resolves | Run bind again from the project root with the correct space name. |
| Agent says no context tree exists | Open ByteRover Desktop and make sure the space has finished syncing, then retry. |
After binding, use Record to save memory and Query to retrieve it.