> ## Documentation Index
> Fetch the complete documentation index at: https://docs.byterover.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Bind

> Connect a project folder to the ByteRover space your agent should use.

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.

<Note>
  The skill does not create spaces. Create the space in ByteRover Desktop, then bind the project folder to it.
</Note>

## Check the current space

Ask your agent:

```text theme={null}
Check which ByteRover space this project is using.
```

The agent checks the current folder's space resolution.

Manual reference:

```bash theme={null}
node scripts/space.mjs current
```

## Bind the project to a space

Ask your agent:

```text theme={null}
Bind this project to the "<space name>" ByteRover space.
```

Replace `<space name>` with the exact space name from ByteRover Desktop.

Manual reference:

```bash theme={null}
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:

```text theme={null}
Check ByteRover space again and confirm this project is bound correctly.
```

Manual reference:

```bash theme={null}
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](/v4/skill/record) to save memory and [Query](/v4/skill/query) to retrieve it.