Scripts, marketplace & AI

PRO A custom script is a small piece of your own JavaScript that Refresh Pilot runs on pages you choose — for example, to dismiss a cookie banner before every refresh, or to click a button the moment your keyword appears. You manage scripts on the web dashboard under Custom Scripts.

⚠️ Only add code you trust. Scripts run with full access to the page — they can read and change anything on it. If you didn't write a script yourself and don't understand what it does, don't add it.

When scripts run — triggers

Each script fires on one trigger:

Trigger	Runs…	Good for
`load`	after each page load	hiding banners, tweaking the page every time it appears
`beforeRefresh`	right before each refresh	saving something on the page before it reloads
`match`	when the monitor finds a match	acting the instant your keyword shows up

🌐 Page loads
(or refresh / match) → 🔍 URL pattern
matches? → 📜 Script runs
on the page

On every trigger, Refresh Pilot checks each enabled script's URL pattern and runs the ones that match.

What a script is made of

A script has a name (up to 80 characters), a description (up to 500), a trigger, a URL pattern, the code itself, and an on/off switch. Limits: up to 50 scripts, each up to 32 KB of code.

URL patterns

The pattern decides which pages a script runs on (default * = everywhere):

With a * in it, it's a wildcard: * stands for "anything". example.com/queue* matches every page whose address starts that way; *dashboard* matches any address containing "dashboard".
Without a *, it's a simple "address contains this text" check.
Matching ignores upper/lower case. It's the same rule auto-start rules use.

One-time Chrome setup: "Allow user scripts"

For safety, Chrome only lets extensions run user-written scripts if you switch it on, and only from Chrome 135 onwards. Until then, scripts are silently skipped — nothing errors, they just don't run. To enable:

Type chrome://extensions in the address bar and press Enter.
Find Refresh Pilot and click Details.
Turn on "Allow user scripts."

ℹ️ The extension's Options page shows a warning until this toggle is on. Scripts also skip quietly on pages Chrome protects (like chrome:// pages) — that's normal.

The marketplace

Don't want to write code? The dashboard's Marketplace page has ready-made community scripts. Browse or search by category, click View to read a script's full code first, then "Add to my scripts" to install your own copy (it counts toward your 50, and duplicates are blocked).

You can share your own scripts too with the ↥ Share button. Submissions are reviewed before they appear publicly, and the server accepts up to 5 submissions per day.

shop.example.com/sneakers

Add to cart

A script on the match trigger can act on the page — like pressing a button — the moment your keyword appears.

Let AI write it for you

Two PRO AI helpers turn plain English into working setups (both run on the Refresh Pilot server, with daily limits set server-side):

AI monitor expression — the ✨ AI button on the popup's Monitor tab and ✨ Generate on the dashboard's Page Monitor page. Describe what you're watching for and it writes the keyword and mode for you, with an explanation. Try: "tell me when it says in stock" or "small or medium available, but not sold out." About 20 uses per day.
AI script — ✨ Generate in the dashboard's Custom Scripts editor. Describe what the script should do — "click the Add to cart button when a match is found" — and it fills in the name, code, trigger, URL pattern, and description. Review the result, then save. About 10 uses per day.

ℹ️ Backing up? Custom scripts are only included in the dashboard's backup file, not the extension Options-page export — details in Cloud sync & backups.

💡 Next: see exactly what's free and what a subscription adds in Free vs PRO.