Install

Install the xcsh Chrome Extension from the Chrome Web Store, then connect the native-messaging bridge to the xcsh CLI. This is a one-time setup for developers and sales engineers.

Prerequisites

• Google Chrome (or a Chromium-based browser)
• The xcsh CLI installed

Install the extension

1. Open the Chrome Web Store listing. Go to the xcsh extension page.

2. Add it to Chrome. Click Add to Chrome, then confirm Add extension.

3. Verify the extension ID. Open chrome://extensions, enable Developer mode (top-right toggle), and confirm the xcsh card shows the ID:

   klajkjdoehjidngligegnpknogmjjhkc

   This is the fixed ID the native-messaging bridge expects.

Connect the native-messaging bridge

1. Run the setup command to register the native-messaging host:

   xcsh chrome setup

2. Reload a console tab. Open or reload a tab on your F5 Distributed Cloud console (*.volterra.us).

3. Confirm the connection. Right-click the extension icon → Options — the status should show Connected to xcsh (green).

Updating

Chrome updates the extension automatically from the Web Store. To force an update now, open chrome://extensions, enable Developer mode, and click Update.

Develop locally (unpacked)

Working on the extension itself? Build a keyed unpacked copy that loads under the same canonical ID as the store build, so the native bridge works while you iterate.

1. Build a dev copy:

   bun run build:dev

   This builds dist/ and injects the store’s public key, pinning the unpacked ID to klajkjdoehjidngligegnpknogmjjhkc (the same ID store users get).

2. Load it. At chrome://extensions (Developer mode on), click Load unpacked and select the dist/ folder. Confirm the ID matches the canonical ID above.

3. Register the bridge with xcsh chrome setup, then reload a console tab.

ملاحظة

Remove the Chrome Web Store copy first if it is installed — Chrome will not load two extensions that share the same ID.