AdGuard Assistant helps you manage filtering right from the browser

Usage no npm install needed!

<script type="module">
  import adguardAssistant from 'https://cdn.skypack.dev/@adguard/assistant';


AdGuard Assistant

AdGuard Assistant is a userscript that helps you manage filtering right from the browser. With its aid you are able to manually block any element, whitelist or report the page, or see the website's security report — all without having to leave the current page.

To get more information on AdGuard Assistant, visit our website https://adguard.com/.

How to report an issue?

GitHub can be used to report a bug or to submit a feature request. To do so, go to this page and click the New issue button.

Our plans

To see the 'big picture', to watch current progress and to get an idea of approximate dates for upcoming AdGuard Assistant releases, see this page: https://github.com/AdguardTeam/AdguardAssistant/milestones


You can find all AdGuard Assistant releases here: https://github.com/AdguardTeam/AdguardAssistant/releases

How to build

yarn install

Command Output Dir
yarn dev build/dev
yarn beta build/beta
yarn release build/release

Each command builds next files inside directory:

  • assistant.meta.js - meta information for userscript
  • assistant.user.js - userscript code
  • assistant.js - code for embedding in another projects (it has functionality for selection of DOM nodes and rules building)
  • build.txt - bamboo environment variables

Embedded version run as:

adguardAssistant().start(null, callback);

Callback returns a rule string.




yarn add @adguard/assistant


npm install @adguard/assistant

Usage of npm module

import { adguardAssistant } from '@adguard/assistant'
adguardAssistant().start(null, callback);


  • write tests