QuillMonkey AI browser automation extension logo

FAQ

How do I work with QuillMonkey? +

Simply prompt the agent with what you would like to change about the website. QuillMonkey has 4 tabs:

  • Chat — send a request to the model and have it respond back.
  • All Chats — see historical chats.
  • Scripts — see scripts, which represent changes QuillMonkey has made to certain websites.
  • Settings — general settings to configure the behavior and appearance of QuillMonkey.
Who maintains QuillMonkey? +
See our team page.
How do I uninstall QuillMonkey? +
Like any other Chrome extension, you can manage your extensions by entering chrome://extensions/ in the Chrome URL bar.
What tools does QuillMonkey use to read and write to websites? +

QuillMonkey's AI agent has access to the following tools:

  • analyzePage — evaluates JavaScript on the page for DOM queries, style extraction, and data gathering.
  • fetchPage — fetches and analyzes the full page content (as markdown, HTML, or with CSS) to answer questions about it. Used as a fallback when analyzePage fails on strict CSP sites.
  • writeNew — creates a new script that executes immediately and is saved for auto-apply on matching pages.
  • update — updates an existing script's code, name, scope, or enabled state.
  • append — appends code to an existing script without re-executing previous code.
  • reExecute — re-runs an existing script on the current page.
  • listScripts — lists scripts with optional filtering by name, host, code content, or enabled status.
  • grabScreenshot — captures a screenshot of the current tab (requires user approval).
  • retrieveChatHistory — searches conversation history for past messages, tool calls, and results.
How do I undo a change QuillMonkey made? +

You can disable scripts:

  1. Locate the script you want to disable. You can do this from the Scripts tab, which lists all scripts, or from the chat itself — click the magnifying glass next to the action that created/updated the script.
  2. Find the Enable toggle and turn it off.
  3. Refresh the page to ensure the script is no longer running.
  4. If there is any strange behavior, file a request on the help page.
Is QuillMonkey ready for release? +
Yes! QuillMonkey is available on the Chrome Web Store. You can also download it from GitHub if you prefer to load the extension manually.
How do I use the extension? How do I open the side panel shown in the demos? +
First ensure that you have the extension installed. (You can check under chrome://extensions.) Then follow the new user instructions. The command to open the side panel is Cmd+Shift+Y, although this can be changed. If it doesn't work, make sure you're hitting the right keys, or try several times. There may be a glitch where the shortcut requires 2 tries to open (I'm.. looking into it). If this does not work, visit the help page.
Why do I have to enable "user scripts" in Chrome settings? +
QuillMonkey works by allowing AI agents (e.g., Claude from Anthropic) to generate scripts that are then executed in your browser. For these scripts to have permission to run, you must manually enable that Chrome setting. This is a Chrome security requirement, and we use a Chrome feature designed for this purpose. We know that users sensitive to permissions-related issues want strong controls, which is why the extension will come with a comprehensive tool-use permission system baked in.
How do I disable certain tools? How do I control permissions in QuillMonkey? +

You can control which tools the AI agent is allowed to use.

  1. Create a new chat, or go to an existing chat.
  2. At the top of the chat, there is a button which looks like a lock.
  3. When you click it, you should see a dropdown, which contains a list of all the available tools.
  4. If a tool is toggled "on", then the agent has access to it. Otherwise, the agent does not have access to it.

You can see the same widget for enabling/disabling tool permissions in the Settings tab. However, that only controls the permissions that new chats will inherit, rather than existing chats.

How does QuillMonkey execute userscripts? +
We use the Chrome scripting.executeScript() API. This is compliant with Manifest V3, which officially designates that API for general-purpose use. This differs from TamperMonkey, which implements its own more sophisticated script execution framework. TamperMonkey is able to do this because its scripts are not pulled from a backend service, and thus not subject to the same stringent requirements. For this reason, TamperMonkey can support some userscript headers (like @grant) that we cannot fully replicate.
Is QuillMonkey compliant with UserScript header conventions? +

Generally yes, although there are some headers we do not support. Unknown headers are preserved when modifying scripts but have no effect.

Header Status
@nameSupported
@matchSupported
@includeSupported
@exclude / @exclude-matchSupported
@versionSupported
@namespaceSupported
@descriptionSupported
@authorSupported
@icon / @iconURL / @defaulticonSupported
@requireSupported (fetched and cached)
@grantParsed but not enforced
@run-atNot supported
@resourceNot supported
@noframesNot supported
@updateURL / @downloadURLNot supported
@sandbox / @unwrap / @inject-intoNot supported
Are there plans to support browsers other than Chrome? +
Yes. Currently we only support Chrome, but we plan to port QuillMonkey to other browsers after the Chrome release, as soon as we have the time and resources.
How do I prevent QuillMonkey from reading certain text? +
Go to the Settings tab, click Advanced Settings, and toggle on Forbidden Outgoing Text. Then enter the text you want to filter out. You can filter multiple strings by putting them on separate lines.
How do I prevent QuillMonkey from making tool calls which contain certain keywords? +
Go to the Settings tab, click Advanced Settings, and toggle on Forbidden Tool Text. Then enter the text you want to filter out. You can filter multiple strings by putting them on separate lines.
How do I export scripts or conversations? +
For scripts, first select the script, then look for the export icon. For conversations, use the "More Actions" menu.
How do I manually edit scripts? +
Navigate to the Scripts tab, select the script you want to edit, and type or delete whatever changes you want. Changes are automatically saved every couple of seconds. The auto-save is separate from versioning (version numbers exist mostly to prevent AI agents from losing your scripts), so don't worry if the version number doesn't increment.
How do I sync scripts across different devices? +
You can do so if you have Google Drive. Go to the Settings tab, and under the Scripts section, click Connect to connect to your Google Drive, then Sync to push/pull changes from your drive. If you update a script separately on 2 different devices, the most recent update will be taken.
Can I publish my scripts so others can use them? +
We consider the scripts you generate to be your intellectual property, so you can download them and share the files with others. As far as the ability to publish scripts natively through QuillMonkey, but we plan to support this in the near future.
Do you save my conversations? +

Your conversations are saved on your computer, under Chrome data. On our side, we do not permanently save your conversations, but we may cache them temporarily for performance reasons. There is more information in the privacy policy.

We log metadata (e.g., number of tokens consumed) but not the content of the conversation itself. The conversations are saved locally in Chrome for you to view, however. You can download them and do what you like with the data.

Can I use QuillMonkey on local files? +
Only if you can open the file in Chrome. Open the file in a tab, open the QuillMonkey side panel on that tab, and prompt the agent from there.
How do I sign in / connect my account? +
Open the side panel, go to the Settings tab, and under the "Account" section, click "Sign in". There should be a pop-up, asking you to sign into your Google account. Make sure you don't have pop-ups blocked, so that Google can request you to sign in. You will need a Google account to sign in with this extension. We won't have access to your Google account or anything; we just use Google to handle authentication for us.
Is QuillMonkey free to use? +
You can install QuillMonkey for free, as well as write + execute userscripts for free. Additionally, you can prompt AI agents on the friee tier, but your usage limits are low, so you may not be able to make very many prompts. To double your usage limit, sign in. For even higher usage limits, see the upgrade page.
How do I build browser extensions with QuillMonkey? +
Your userscripts can be converted into browser extensions. I will provide more information about this soon, and I plan to support this workflow more heavily in the future.
Where are the scripts actually saved on my computer? +
Scripts are stored inside your Chrome profile's extension data directory. The exact path depends on your operating system:
  • macOS: ~/Library/Application Support/Google/Chrome/Default/Extensions/[EXTENSION_ID]
  • Linux: ~/.config/google-chrome/Default/Extensions/[EXTENSION_ID]
  • Windows: Look for the extension ID under HKEY_LOCAL_MACHINE\Software\...\Google\Chrome\Extensions\
You can find the extension ID on the chrome://extensions page. The path may vary slightly depending on your Chrome version or if you're using a Chromium-based browser. You don't usually need to access this directory directly — you can manage scripts from the Scripts tab and use the export feature to back them up.
Is QuillMonkey slowing down my computer? +

It's unlikely that the extension itself is slowing down your computer. However, one of your userscripts may be slowing down a website. If you suspect this, you can try disabling it and comparing the before-and-after load times.

To find all the scripts which run on a particular page:

  1. Open that page.
  2. Open the side panel.
  3. Go to the Scripts tab.
  4. Click on the button to the right of the search bar to open advanced settings.
  5. Click on "Only scripts for this page" to apply that filter.
How do I disable ALL scripts and restore default website behavior? +
  1. Open the side panel.
  2. Go to the Settings tab.
  3. Under the "Scripts" section, toggle "Apply on page load" to off.
  4. Refresh any pages which need to be refreshed.

If you do this, it will not delete your scripts, and you will not lose the metadata about which scripts were enabled or disabled before you toggled it. This option just allows you to temporarily/blanket disable all QuillMonkey changes.

Is QuillMonkey available in non-English languages? +
Not currently. If you would like to help with localization, feel free to contact us at sean@quillmonkey.com.
How do I search through conversations? +
The easiest way is to use the browser-native Cmd+F command, however that won't work while the content is in the side panel. To open full-screen mode, click on the Open in full page icon (↗) at the top-right of the extension. In full-screen mode, you will be able to use Cmd+F.
Why did you choose the name "QuillMonkey"? +
I was drawn to the icon of the quill, because it represents the spirit of creation, with an old-fashioned twist. The ending "Monkey" is common for browser extensions which are userscript managers.
How can I support QuillMonkey? +
  1. Give us a 5-star rating on the Chrome Web Store.
  2. Spread the word by telling your friends or posting on social media.
  3. Upgrade to a higher usage subscription.