Skip to content

Chrome extension

Send the tab you are looking at to a PiCode agent — URL, title, selected text, optional screenshot. The agent is the one you already created.

  • Where: load ext/ in Chrome (chrome://extensions, Developer mode, Load unpacked), then picode extension-install.
  • Not this: not a second chat, and not the work browser the agent uses for its own work.

Install

  1. In Chrome open chrome://extensions, turn on Developer mode, Load unpacked, and pick the ext/ folder of this repo.
  2. Register the native host so the extension can reach PiCode:
bash
picode extension-install

Chrome on Windows with PiCode inside WSL — the tool binary cannot be the host (it links as a GUI program). make desktop builds a console sibling, picode-nmh.exe. Then:

text
picode-desktop extension-install
  1. Pin PiCode on the toolbar. Click it to open the side panel, or right-click a page → Send to PiCode.

picode extension-uninstall (or picode-desktop extension-uninstall) removes the host registration. The unpacked extension you remove in chrome://extensions.

Use

Pick an agent, type an optional message, Send. A stopped agent starts first (Start and send). An agent that is already working queues a follow-up. An agent running in the terminal is not switched from here — open PiCode instead.

chrome:// pages, the Web Store, and local files cannot be sent.

Let the agent act on the page

Tick Let the agent act on this page before sending. The agent can then reply with steps — click, fill, press, read, scroll — which the panel runs on the page one by one, highlighting each element before it fires. You see every step; Stop halts the loop at any point.

  • First time on a site the panel asks: Allow once, and it remembers (per site). Nothing runs on a site you have not allowed.
  • The agent gets the results and can continue — at most 3 rounds.
  • Keep the panel open while it works; closing it pauses the loop, and an unanswered request expires after 10 minutes.
  • The page changed mid-run? The remaining steps are marked "page changed" and the agent is told.

This is the page you are looking at, under your hand. Long, unattended browser jobs still belong to the agent's own browser, not to this panel.

Requirements

PiCode must be running on this machine. The extension talks to it through the host registered above, not through a pasted URL.