Cuardaigh — Irish for "to search"
A Chromium Manifest V3 browser extension that adds a floating search query builder panel to supported search-engine result pages. Cuardaigh surfaces the operators, dork patterns, and reusable templates that mainstream search engines support, in a clean panel that lives alongside your results.
Query Builder — Compose queries from plain terms, exact phrases, exclusions, site filters, file types, content-location operators (intitle:, inurl:, intext:, allintitle:, etc.), date ranges, language, and location. The generated query is previewed live and operator conflicts are flagged inline.
Operators Reference — A full catalogue of search operators supported by mainstream engines, filtered to whichever engine you are currently on, with clickable examples that populate the builder.
Templates — Pre-built query patterns covering everyday research, document finding, competitive research, OSINT, and security dorking. Fill in the fields and apply to the builder in one click.
Dork Library — A curated set of Google Hacking / OSINT search patterns organised by category with severity classification and target-aware syntax substitution. Includes pre-defined campaigns (groups of dorks run together), external OSINT tool deep-links, and a custom dork builder with JSON import/export.
| Engine | Status |
|---|---|
| Supported | |
| Bing | Supported |
| DuckDuckGo | Supported |
| Yandex | Beta |
| Brave Search | Beta |
| Startpage | Beta |
Cuardaigh is not published to the Chrome Web Store. Load it manually from source.
Prerequisites: Node.js 18+
npm install
npm run build- Open
chrome://extensions - Enable Developer mode
- Click Load unpacked
- Select the generated
dist/folder - Visit a supported search page and click the floating Cuardaigh button
Windows / PowerShell: If
npmis blocked by your execution policy, usenpm.cmdin place ofnpm.
npm install # install dependencies
npm test # run unit tests (Vitest)
npm run build # bundle to dist/Tests cover query building, engine adapters, and template composition.
Cuardaigh is strictly local:
- No backend, analytics, accounts, or telemetry
- No external API calls or remote code
- No synced storage or cookies
- Builder state, the target domain, and custom dorks are saved to
localStorageon the current search page only — nothing leaves your browser
The manifest uses static content-script matches for supported search pages and requests no additional browser permissions.
See PRIVACY.md for full details.
- React 19 + TypeScript — content script UI
- Vite — bundled as a single IIFE, mounted via Shadow DOM
- Vitest — unit tests
- Lucide React — icons