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

# Codex CLI

> Connect Codex CLI on a VPS or remote development machine to ByteRover V4.

Use the published ByteRover skill to give Codex CLI access to persistent project memory on a VPS or any terminal environment.

## Before you start

* Install and authenticate Codex CLI on the VPS.
* Open the project folder in the same shell where Codex CLI runs.

## Install the ByteRover skill

Run this on the VPS:

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 Codex CLI runs.

## Restart Codex CLI

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

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

Agents load installed skills when a new session starts.

## Onboard with ByteRover

Prompt Codex CLI:

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

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

## If Codex CLI needs a space

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

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

## If Codex CLI asks you to sign in

Codex 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 VPS terminal.
4. Type:

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

## Verify

Ask Codex CLI to check ByteRover before starting work:

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

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