Skip to main content
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.

​
Optional step 0: Remove old V3 CLI, connectors, and integrations

If this VPS still has the old V3 CLI, connectors, OpenClaw integration, or Hermes memory provider installed, remove them before setting up the V4 skill:
This removes old V3 command-line tools and connectors. It also removes the old OpenClaw integration and Hermes memory provider when they are detected. It does not migrate V3 memory data.

​
Install the ByteRover skill

Run this on the VPS: Requires Node.js 20 or newer. Node.js includes npm and npx.
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:
Agents load installed skills when a new session starts.

​
Authenticate with ByteRover

Prompt Codex CLI:
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:

​
Onboard with ByteRover

Prompt Codex CLI:
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:

​
Verify

Ask Codex CLI to check ByteRover before starting work:
After setup, Codex CLI should query memory before non-trivial work and record useful project knowledge when work is complete.

​
Next steps

Query

Learn in depth how the agent retrieves project memory.

Record

Learn in depth how the agent saves durable knowledge.

Space

Manage where this project’s memory lives.