Web Potions

You look at websites all day, and whatever they show you goes straight into your head. Web Potions is a Chrome extension that lets you decide what gets through.

Every tweak is a potion: a small bundle of changes that runs by itself on the sites you choose. Brew one by pointing and clicking, or pour in your own CSS and JavaScript. One extension instead of a drawer full of half-working ones.

Potion catalog

Ready-made potions to start with. Once Web Potions is installed, click Browse in the toolbar popup and Get any of these. One click and it's on your shelf.

Potion	Works on	What it does
Instagram, no pictures	instagram.com	Every photo and video on Instagram turns invisible. Captions and comments stay.
YouTube, no recommendations	youtube.com	The home feed, the Up next sidebar and end-screen suggestions disappear. Search and Subscriptions still work.
YouTube, no Shorts	youtube.com	Hides the Shorts tab, Shorts shelves, and Shorts in feeds and search results.
Gray mode	Any page, when you drink it	Drains the color out of any page. Less slot machine, more newspaper.
Hide all images	Any page, when you drink it	Every image becomes a blank tile. Hover one to peek.
Hype detector	Any page, when you drink it	Lights up buzzwords, so you can see how hard a page is selling.
Night mode	Any page, when you drink it	Turns any page dark by flipping its colors. Photos and videos stay normal.

Brewed a good one? Share it as a .potion.json, drop it in potions/, run node scripts/build-catalog.mjs and open a pull request.

Install

1. Open Web Potions on the Chrome Web Store and click Add to Chrome.
2. The welcome page that opens walks you through two quick steps: switch on Allow User Scripts, and pin the purple potion to your toolbar. Chrome asks for Allow User Scripts before any extension can run your own scripts on pages.

Works in Chrome 135 and newer.

From source

To try changes before they reach the store, load it yourself. It takes a minute:

1. Download this repo (Code → Download ZIP, then unzip it) or git clone it.
2. Open chrome://extensions and switch on Developer mode (top right).
3. Click Load unpacked and choose the extension folder.
4. Click Details on Web Potions and switch on Allow User Scripts.
5. Pin the purple potion to your toolbar.

Each copy keeps its own potions. To move them from one copy to the other, open Settings (the gear in the popup), click Export all in one, then Import potions in the other.

Brew your first potion

1. On any page, click the potion in your toolbar, then Create new potion.
2. If the page has a stuck banner or stuck scrolling, it's already listed under Spotted on this page. Click Fix, or Fix all, and watch it go.
3. Add more ingredients from the grid, check Works on, and Save potion.

Next time you visit, the potion runs on its own, before the page has finished loading.

AI mode

Let an AI that drives your browser, like Claude in Chrome, fix sites for you. It looks at the page, tries a fix, reloads to check it, then saves what works and turns it on, with no clicks from you.

Set it up in two steps:

1. Click the potion in your toolbar, then the gear, and switch on AI mode.
2. Click Copy instructions for your AI right there, paste them into your AI, and say what you want changed. To skip the pasting, copy extension/skill/web-potions into its skills folder (for Claude Code, that's ~/.claude/skills/).

Your AI has to drive your real Chrome, so use Claude in Chrome or something like it. Built-in browser panes and cloud browsers don't have your extensions, so an AI can't reach Web Potions from them.

Turn things off the same way you always would. Anything an AI saves is tagged AI.

Browse has a switch for every potion you own, and that's where you delete them:

How it keeps websites out

A website's scripts can send the same messages your AI sends, so a switch alone wouldn't be safe. So the AI starts by pressing Ctrl Alt Shift P with its real keyboard action, which page scripts can't fake. That unlocks one tab for one site, until it leaves the site, closes the tab or 30 minutes pass.

• Until then, Web Potions doesn't answer page messages at all, so sites can't even tell it's installed.
• The first time an AI works on a site, a separate window asks you to allow it. About 100 popular sites skip the question, and you can switch that off in Settings. Email, banks, payments and dedicated sign-in sites are never on that list.
• The AI can only save potions for the site it's on. It can't touch other sites, every-site potions or iframes.
• The AI can't delete anything. It can only edit or switch potions on that site.
• While AI mode is on, the toolbar icon says AI, so you remember it's on.
• While an AI can act on a tab, a badge on the page says Operated by AI, and a card lets you lock it out.

The risk you accept by turning it on: a page could trick your AI into saving a bad potion. That code would keep running on that site after the AI has gone, with no click to stop it first. So every save shows a card with an Undo button, and the AI tag makes these potions easy to find.

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗