Getting started

What you need#

• Chrome 138 or later, or one of the other supported browsers.
• An AI provider. A paid ChatGPT plan, an API key from OpenAI, Anthropic, Google, or xAI, or any endpoint that speaks the OpenAI API, such as OpenRouter, Ollama, or a server on your own machine. ChatGPT Free does not work: it does not include model access for other apps.

Remixlet itself is free. What you pay for is the model, and only while the agent is working. More on that under What it costs.

Install and connect a provider#

1. Install Remixlet from the Chrome Web Store. A welcome tab opens.
2. Pin Remixlet to your toolbar. Click the puzzle-piece "Extensions" icon, then the pin next to Remixlet. You will use this button a lot.
3. Connect a model provider. Choose "A subscription" to sign in with ChatGPT, or "API key" for everything else.
   • ChatGPT: "Continue with ChatGPT" opens an OpenAI sign-in tab. Confirm your account there and come back. It connects on its own.
   • An API key: paste it into the "API key" field. The form links to the page where that provider issues keys.
   • An OpenAI-compatible endpoint: enter its base URL, up to and including the version segment (for example https://openrouter.ai/api/v1). Leave the key blank for a local server that has no authentication.
4. Press "Connect and find models". Remixlet checks the connection and lists the models you can pick in chat.

You can add, edit, or remove providers later under Settings › Providers.

Make your first remixlet#

1. Go to the site you want to change.
2. Click the Remixlet toolbar button, then "Open chat". The chat opens in the browser's side panel. Remixlet also suggests a keyboard shortcut, Ctrl+J (Command+J on a Mac). If it doesn't work in your browser, set your own at chrome://extensions/shortcuts.
3. Check the model. The model chip sits in the message box. The first provider you connect sets the default, and you can switch at any time, even mid-chat.
4. Describe the change and send it.

Describe the result you want to see, in your own words. You don't need to know how the page is built. "Hide the sponsored results" works; so does "show the price per night including fees". If it's hard to say which part of the page you mean, use the draw tool (✎) to box an element or add an arrow and a note, then send that with your message. If the change should apply to more than this one page, say so: "on every listing, not just this one".

What happens next#

The agent looks at the page and first checks whether the change is possible there. If it isn't, it says what it found. You can often help by pointing it at another page on the same site that shows the information.

If the change needs more than reading and changing the page, such as remembering something between visits or fetching data from another host, a "Remixlet needs permission" card appears in the chat. It lists each permission in plain words, with "Not now" and "Allow".

The agent then writes the remixlet and applies it, which reloads the tab. While it works, a small bar on the page says so, with a "Stop" button. Anything you type into the page in the meantime may be lost to the reload. If a new version would run on more sites than before, or change which requests the page makes, a dialog asks first. "Don't allow" keeps the previous version running.

When a version is applied, "v1 applied" appears in the chat. "Show what changed" outlines every spot on the page the remixlet touched. Try the change for real. If anything is off, tell the agent what you did, what happened, and what you expected, and it will fix it.

The chat is tied to the tab it started on. If you switch tabs, the agent keeps working on the original one. If you close that tab, the agent stops and offers to reopen it.

Using your remixlets#

From then on, the remixlet runs by itself every time you open a matching page. It does not use the AI model, and it costs nothing to run.

The toolbar popup shows the current site's remixlets under "Used on this page" and "Others", each with an on/off switch. "Pause" turns off every remixlet on the site at once and reloads its tabs; "Resume" brings them back. If a remixlet added its own commands, they appear under "Commands" with a "Run" button. The number on the toolbar button is how many remixlets are running on the current tab.

The manager, opened with "Manage" in the popup, lists every remixlet grouped by site. Each remixlet has two tabs:

• Overview shows its README (what it is for), the permissions it holds, and how often it has run.
• History lists every version, grouped by the chat that made it. "Changes" shows what a version changed, "Code" shows its full code, and "Restore" goes back to it. If an older version held permissions the current one does not, restoring asks you to allow them again.

The "⋯" menu on a remixlet has "Archive" and "Delete". Archive turns it off and moves it out of the way; you can restore it later. Delete removes the remixlet, its version history, its stored data, its schedules, and every permission it held. It cannot be undone.

Past chats are listed under "Conversation history" in the panel, where you can pick one up again. The manager's Chats page shows the same chats read-only. Its "Run log" tab lists every step the agent took, with the tokens and estimated cost of each.

When a remixlet stops working#

Sites change their pages, and a remixlet written for the old page can quietly stop doing its job. Remixlet does not detect this for you. When you notice:

• Ask for a fix. Open the chat on that site and say what is wrong. The agent reads the remixlet's README, which records what you originally asked for, then its code and its log, and repairs it.
• Roll back. If an older version worked, restore it from History.
• Turn it off from the popup while you decide.

A remixlet marked "Not running" is one the extension refused to run, for example because its stored files no longer pass a check. Hover over the label for the reason. Update it from a chat, restore an earlier version, or delete it.

What it costs#

Remixlet charges nothing. Your provider bills for the model's work while the agent is building or fixing a remixlet, at that provider's usual rates. A finished remixlet never calls the model.

With an API key, the row under the chat shows the output tokens the model has written so far and an estimated cost for the chat at list prices, such as "~$0.31". A ChatGPT plan has no per-chat price, so no estimate is shown.

Settings#

Settings has three tabs:

• General: "Theme"; "Chat detail", which sets how much the agent says while it works ("Quiet", "Standard", or "Detailed", which adds the model's own working notes); and "Permission alerts", a system notification when the chat is waiting for you to allow something and is out of view.
• Providers: add, edit, refresh, or remove providers.
• Experiments: "Check changes after writing", off by default. When it is on, the agent checks each change after applying it: it looks at the page, clicks the control it added, reviews the look, and fixes what the checks find. A change that fails is put back to the previous version or taken off the page. Each change costs more model calls.

What Remixlet does not do yet#

• Share, export, or import remixlets. They live in the browser that made them. There is no install link, no marketplace, and no file export.
• Sync between browsers. Each browser profile has its own remixlets.
• Change browser pages. Remixlets run only on regular websites, not on settings pages, other extensions, or the Chrome Web Store.