BrowserKitten README

The project's README from github.com/Player-YN/BrowserKitten. As one markdown file: README.md.

爪爪 · PawWork

English · 中文

license last commit JavaScript Chrome MV3 unpacked

Treat the already-logged-in Chrome as a programmable computer. 爪爪 is the agent on that machine.

sidepanel → service worker → offscreen agent · tools: action · run+sys · sheet / doc / web

What you get · Run it · Limits · Use cases · Mechanism · Next

爪爪 · 完全解放版: the already-logged-in Chrome is a programmable computer. 爪爪 is the agent on that machine.

爪爪 · 完全解放版 (PawWork_ZhuaZhua) is a Chrome MV3 unpacked extension. Not a selection widget. Not a Chrome Web Store app.

What you get

An unpacked side-panel agent that can operate the current tab, run guest JS against the browser (sys inside run), and keep sheet / Univer doc / site HTML in the session.

Logged-in Chrome shop tab as the machine. The 爪爪 side panel docks onto it after you load this folder unpacked.

Anything a Tampermonkey userscript could do is in scope. There is no userscript store. One packaged playbook ships: page-restyle.

Run it

You should see a side-panel agent named 爪爪 · 完全解放版. There is no Chrome Web Store listing.

  1. Download the Release zip or clone this repo and use the extension/ folder
  2. Chrome → chrome://extensions → Developer mode → Load unpacked → select that folder (manifest.json is at its root)
  3. Open the side panel → paste a BYOK key (pagewand_providers) → send a task on a normal http(s) page

After you edit files in the load folder, click 重新加载 on the extension card. No daily npm.

Limits

These change whether you load it, and what the first task can touch.

Need Chrome 135+. Chrome 138+: extension details → Allow User Scripts if you need sys.eval / page fetch. Close F12 on the target tab before CDP (CDP_BUSY). Restricted pages (chrome://, Web Store) return NEED_PAGE.

If you wanted What exists
CWS install No. Unpacked only.
Hosted model No. BYOK.
A Tampermonkey catalog No. Skill: page-restyle.
chrome:// / Web Store pages NEED_PAGE.

Use cases

Tried and plausible — not a benchmark list, not a store.

Six jobs: restyle versus clutter, logged-in scrape into a grid, form fill with action refs, page-identity download, tab batch and SPA navigate, reading-aid overlay.

Mechanism

Live-page action snapshot with ref chips, run plus sys.fetch as page writing a CSV, and sheet, doc, and site canvases. Plan card is session-only.

Side panel → service worker → offscreen SessionWorkspaceService → AI SDK ToolLoopAgent.

You call It does
action Live tab. snapshot, then mutate with that generation’s ref + rev
run Sandbox JS. Guest sys: tabs, eval, fetch, cdp, download, screenshot
sheet / doc / web Univer table, Univer document, data-paw-kind=site
inspect / acquire / clarify Read the session, bring public web in, pause for a question or plan

sys is not a model tool. Login / cookies / captcha: sys.fetch({ as: "page" }) inside run.

Next

Architecture and tool contracts: AGENTS.md. 中文首页:README.zh-CN.md.

node --test tests/runtime-regression.test.mjs

License

MIT.

BrowserKitten (Player-YN/BrowserKitten)

Searching Database…

What is this?BrowserKitten (爪爪 / PawWork) is a side-panel Chrome agent that treats your already-logged-in browser as a programmable computer: you select something on the live page, describe the outcome you want, and it hands back an editable sheet, Univer document, or page snapshot.
Is this a Chrome Web Store app or something else?It is an unpacked Chrome MV3 extension you load yourself through Developer mode, not something installed from the Chrome Web Store.
How do I get it running?Download the Release zip or clone the repo and point Chrome at the extension/ folder, then load it as an unpacked extension via chrome://extensions → Developer mode → Load unpacked, and open the side panel.
Do I need an API key to use it?Yes — it is BYOK, so you paste your own provider API key straight into the side panel; you also need Chrome 135+ (138+ to enable 'Allow User Scripts' for sys.eval/page fetch).
What won't work with this?Restricted pages such as chrome:// URLs or the Web Store return a NEEDPAGE error and can't be automated, and you must close DevTools (F12) on the target tab before the agent's CDP connection works.
What can it actually do out of the box?It ships one packaged playbook, page-restyle, plus demonstrated use cases: scraping a logged-in page into a sheet, auto-filling forms, downloading files with your page identity, batch-processing tabs, and injecting reading aids.
How does the agent work under the hood?Requests flow from the side panel to a service worker to an offscreen SessionWorkspaceService built on an AI SDK ToolLoopAgent, which calls 'action' (snapshot/mutate the live tab), 'run' (sandboxed JS with sys helpers for tabs/eval/fetch/cdp/download/screenshot), and sheet/doc/web tools backed by Univer.
Why isn't this on the Chrome Web Store?It is built deliberately as unpacked-only with no hosted model and no userscript catalog — BYOK by design, trading store convenience for full control over what the agent is allowed to run.
What kind of files does a task hand back?Depending on the task it returns an editable Univer spreadsheet or document, or a captured site-HTML snapshot, so a browsing task ends up as something you can keep editing.
Creator
Player-YN
Size
17.4 MB
Stars
2.4K
Age
1mo
Commits · 90 Days