Skip to content

browser-extension.mdx

Latest commit

 

History

History
142 lines (108 loc) · 3.91 KB

browser-extension.mdx

File metadata and controls

142 lines (108 loc) · 3.91 KB
Raw
title Browser Extension
description Install and configure PalanK Browser Relay for Chrome

Overview

PalanK Browser Relay is a lightweight Chrome extension that connects your browser tabs to PalanK Agent. It uses Chrome's built-in debugging protocol (CDP) to enable AI-powered browser automation.

The extension only activates on tabs you explicitly attach. Your browsing history and data are never collected.

Installation

Chrome Web Store (Recommended)

<Card title="Install from Chrome Web Store" icon="chrome" href="https://chrome.google.com/webstore/detail/palank-browser-relay"

One-click installation with automatic updates

Manual Installation (Developer Mode)

For testing or development purposes:

Download the extension files from [GitHub releases](https://github.com/PALAN-K/palank-opemclaw/releases). Navigate to `chrome://extensions` in Chrome. Toggle "Developer mode" in the top right corner. Click "Load unpacked" and select the extension folder.

Usage

Attaching a Tab

  1. Navigate to the webpage you want to control
  2. Click the PalanK Browser Relay icon in the toolbar
  3. Wait for the badge to show "ON"
Chrome will show a warning: "PalanK Browser Relay started debugging this browser". This is normal - it's how the extension controls the page.

Detaching a Tab

Click the extension icon again to disconnect. The badge will disappear.

Badge Status

Badge Meaning
ON (orange) Tab is connected and ready
... (yellow) Connecting to relay server
! (red) Cannot reach relay - PalanK app not running
(none) Tab not attached

Configuration

Changing Relay Port

If you've configured PalanK to use a different port:

  1. Right-click the extension icon → Options
  2. Enter the new port number
  3. Click Save
Default port is `18792`. Only change this if you've modified PalanK's CDP settings.

How It Works

sequenceDiagram
    participant User
    participant Extension
    participant Gateway as PalanK Gateway
    participant AI as Claude AI

    User->>Extension: Click icon
    Extension->>Gateway: WebSocket connect
    Gateway-->>Extension: Connected
    Extension->>Extension: Attach debugger
    Note over Extension: Badge shows ON

    AI->>Gateway: Send command
    Gateway->>Extension: Forward CDP command
    Extension->>Extension: Execute on page
    Extension->>Gateway: Return result
    Gateway->>AI: Command result
Loading

Permissions

The extension requires these permissions:

Permission Purpose
debugger Control page via Chrome DevTools Protocol
tabs Access current tab information
activeTab Interact with active tab when clicked
storage Save relay port configuration
host_permissions Connect to local relay server
All communication stays on `127.0.0.1` (localhost). No data is sent to external servers.

Limitations

The extension cannot control:

  • Chrome internal pages (chrome://, edge://)
  • Chrome Web Store pages
  • Other extensions' pages
  • PDF viewer

Troubleshooting

Make sure PalanK Desktop app is running. The extension needs the local gateway server to function. Go to `chrome://extensions`, disable and re-enable the extension. Some pages with strict Content Security Policy may limit functionality. Try refreshing the page after attaching.