Skip to main content

​
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

Install from Chrome Web Store

One-click installation with automatic updates

​
Manual Installation (Developer Mode)

For testing or development purposes:
1

Download Extension

Download the extension files from GitHub releases.
2

Open Extensions Page

Navigate to chrome://extensions in Chrome.
3

Enable Developer Mode

Toggle “Developer mode” in the top right corner.
4

Load Extension

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

BadgeMeaning
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

​
Permissions

The extension requires these permissions:
PermissionPurpose
debuggerControl page via Chrome DevTools Protocol
tabsAccess current tab information
activeTabInteract with active tab when clicked
storageSave relay port configuration
host_permissionsConnect 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.