BrowserPilot

an agent that lives in your browser sidepanel to handle and automate browsing tasks , it can navigate , summrize,fill forms , work on repeptive/tedious tasks , organizing tabs , just tell it what to do ...

Quick Start

1. Install Extension

From Release (Recommended)

1. Download the latest release from GitHub Releases
2. Extract the ZIP file
3. Open Chrome → chrome://extensions/
4. Enable Developer mode → Load unpacked
5. Select the extracted dist folder

2. Setup Server (Global install first)

npm install -g @ayoubj/browserpilot
browserpilot setup

The setup wizard writes your configuration and provider keys to platform-specific config files.

Start the server (normal mode):

browserpilot

Optional debug mode (verbose logs):

browserpilot --debug

Or run directly with npx (no global install):

npx @ayoubj/browserpilot setup
npx @ayoubj/browserpilot

Server runs at http://localhost:8080 by default and prints a clean running message unless debug is enabled.

3. Development (Clone + Build)

Clone/install/build is only needed if you want to develop BrowserPilot locally.

pnpm install
pnpm run build

Then load dist/ in Chrome as described above.

4. Open Sidepanel

Press Ctrl+Shift+K (or Cmd+Shift+K on Mac) or click the extension icon → "Open side panel"

Configuration

Browser Pilot stores plain-text JSON config in your home config directory:

• Linux: ${XDG_CONFIG_HOME:-~/.config}/browserpilot/config.json
• macOS: ~/Library/Application Support/browserpilot/config.json
• Windows: %APPDATA%\\browserpilot\\config.json

OAuth flow records are stored in oauth.json in the same directory.

Useful commands:

browserpilot setup
browserpilot config list
browserpilot
# fallback:
npx @ayoubj/browserpilot

Features & Examples

See docs/FEATURES.md for:

• Available tools (tabs, groups, history, page content)
• Usage examples
• Screenshots
• Architecture deep-dive