# ghostery/adblocker

> adblocker is a JavaScript library for blocking ads, trackers, and annoyances, with a strong focus on efficiency. It applies filters written in the uBlock Origin and Easylist formats to decide what to block, and it can be embedded in other software. The library is written mainly in TypeScript.

Source: https://github.com/ghostery/adblocker
Indexed: commit ff8ed92 on 2026-09-01 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Library
- Language: TypeScript
- Stars: 1,019 at index time
- License: MPL-2.0
- Code health: 9.0/10, Excellent
- Last commit: 2026-08-14
- Contributors: 11

## How it works

Most of the code sits under the packages directory. The core engine is in packages/adblocker/src/engine/engine.ts, which is one of the hotspot files in the index. The packages/adblocker/src/codebooks/ directory holds modules for network filters, cosmetic selectors, network hostnames, and raw network rules. The packages/adblocker-content/package.json manifest describes the content package that sits alongside the core library. Integration packages such as @ghostery/adblocker-webextension, @ghostery/adblocker-puppeteer, and @ghostery/adblocker-electron connect the core to each host environment. The bench/comparison/blockers/ directory contains entry points for comparing this library with other blockers.

- bench/comparison/blockers/adblockfast.js: entry point
- bench/comparison/blockers/adblockplus.js: entry point
- bench/comparison/blockers/brave.js: entry point
- bench/comparison/blockers/cliqz-base.js: entry point
- bench/comparison/blockers/cliqz-compression.js: entry point
Modules: packages, bench, root, .github. 215 files, 98,451 lines, 1,046 symbols.

## Code health

- Score: 9.0/10 (Excellent)
- Rank: #19 of 4,000+ indexed repos
- Hotspots: packages/adblocker/src/codebooks/network-hostname.ts, packages/adblocker/src/codebooks/raw-network.ts, packages/adblocker/src/codebooks/network-filter.ts, packages/adblocker/src/codebooks/cosmetic-selector.ts, packages/adblocker/src/engine/engine.ts
- Lowest file: packages/adblocker/src/filters/network.ts
- Dead code: 6 findings

## Maintenance

- Last commit 2026-08-14, first commit 2025-06-19, 505 commits
- 11 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/ghostery/adblocker/security

## More

- Page: https://repowise.dev/repo/ghostery/adblocker
- Ask this codebase: https://repowise.dev/repo/ghostery/adblocker/chat
- Docs: https://repowise.dev/repo/ghostery/adblocker/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/ghostery/adblocker
