> ## 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.

# OpenCode CLI

> Connect OpenCode CLI on a VPS or terminal session to ByteRover V4.

Use the published ByteRover skill to give OpenCode CLI access to persistent project memory from a VPS, remote shell, or local terminal.

## Before you start

* Install and authenticate OpenCode CLI in the terminal where you will work.
* Open the project folder in the same shell where OpenCode CLI runs.

## Install the ByteRover skill

Run this in the terminal environment where OpenCode CLI runs:

Requires Node.js 20 or newer. Node.js includes npm and npx.

```bash theme={null}
npx skills add campfirein/skills
```

Run the command in the same environment where OpenCode CLI runs.

## Restart OpenCode CLI

Stop the current OpenCode session, then start a new one in the project:

```bash theme={null}
cd path/to/your/project
opencode
```

Agents load installed skills when a new session starts.

## Onboard with ByteRover

Prompt OpenCode CLI:

```text theme={null}
onboard with byterover
```

OpenCode CLI checks whether the project is linked to a ByteRover space.

## If OpenCode CLI needs a space

Open ByteRover Desktop, create or select the space for this project, then prompt OpenCode CLI again:

```text theme={null}
onboard with byterover
```

## If OpenCode CLI asks you to sign in

OpenCode CLI may print a browser URL and ask you to approve the connection.

1. Open the URL in your browser.
2. Approve the request before the code expires.
3. Return to the terminal.
4. Type:

```text theme={null}
approved
```

## Verify

Ask OpenCode CLI to check ByteRover before starting work:

```text theme={null}
query byterover for this project
```

After setup, OpenCode CLI should query memory before non-trivial work and record useful project knowledge when work is complete.