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

# Hermes

> Connect Hermes to ByteRover V4 with the published skill, authentication, and onboarding prompt.

Use the published ByteRover skill to give Hermes access to persistent project memory.

<img src="https://mintcdn.com/demo-a750c123/LcC02bNs7AlzliOm/v4/assets/HermesxAgent.jpeg?fit=max&auto=format&n=LcC02bNs7AlzliOm&q=85&s=cc2460e895e566333b3dbc7b35a832e8" alt="ByteRover and Hermes agent integration" width="760" data-path="v4/assets/HermesxAgent.jpeg" />

## Setup

<Steps>
  <Step title="Optional step 0: Remove old V3 CLI, connectors, and integrations">
    If this machine still has the old V3 CLI, connectors, OpenClaw integration, or Hermes memory provider installed, remove them before setting up the V4 skill:

    ```bash theme={null}
    curl -fsSL https://www.byterover.dev/uninstall-v3.sh | sh
    ```

    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.
  </Step>

  <Step title="Install the ByteRover skill">
    Run:

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

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

  <Step title="Restart Hermes">
    Fully quit and reopen Hermes so it can load the installed ByteRover skill.
  </Step>

  <Step title="Authenticate with ByteRover">
    Prompt Hermes:

    ```text theme={null}
    Authenticate with ByteRover.
    ```

    Open the URL Hermes prints, approve the request in your browser, then return to Hermes and type:

    ```text theme={null}
    approved
    ```
  </Step>

  <Step title="Start ByteRover onboarding">
    Prompt Hermes:

    ```text theme={null}
    onboard with ByteRover
    ```
  </Step>
</Steps>

## Authentication URL flow

Hermes may ask you to finish account linking in the browser.

<img src="https://mintcdn.com/demo-a750c123/jPL6wCDtHodEH7ea/images/v4/autonomous-agent-auth-url.svg?fit=max&auto=format&n=jPL6wCDtHodEH7ea&q=85&s=53eab413e3d175016c4675beddba12e4" alt="Agent ByteRover authentication URL flow" width="760" data-path="images/v4/autonomous-agent-auth-url.svg" />

Follow the URL flow exactly as Hermes prints it before you start onboarding:

1. Tell Hermes to start the authentication flow.
2. Open the URL that Hermes prints in your browser.
3. Confirm the browser page before the code expires.
4. Return to Hermes and type:

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

<Note>
  Use the URL and code printed by your Hermes session. Do not copy values from the example image.
</Note>

## If Hermes needs a space

During onboarding, Hermes may tell you that ByteRover is not configured for the current workspace.

When that happens:

1. Open ByteRover Desktop.
2. Create or select the space for this project.
3. Return to Hermes.
4. Prompt Hermes again:

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

Hermes checks the current project again and continues setup.

## Verify

After onboarding, ask Hermes to check ByteRover before starting work:

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

Hermes should use ByteRover automatically after setup: query before non-trivial work and record useful knowledge when the work is complete.