ai-agent

AdGuardHome

Name: AdGuardHome
Author: AdguardTeam

Network-wide ads & trackers blocking DNS server

36,267 stars2,471 forksTypeScriptUpdated 8/20/2026100% free · open source

What it does

AdGuard Home runs a DNS server that blocks ads, trackers and malicious domains for every device on your network.

When to use it

•You want to protect all team devices (laptops, phones, IoT) without installing blockers on each one.
•Your SaaS product runs behind a corporate network and you need to cut bandwidth‑hogs like ad‑servers.
•You need a simple, self‑hosted alternative to cloud‑based DNS filters for compliance or privacy reasons.

Ready-to-paste prompt

dig @127.0.0.1 -p 53 example.com +short   # shows the filtered IP address returned by AdGuard Home

Heads up: Ports 53/80/443 are privileged; if you run the container without root you must map them to higher host ports (e.g., `-p 1053:53/udp`) and configure your network to use those ports, or run the container with `--cap-add=NET_BIND_SERVICE`.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/adguardhome && curl -fsSL https://workflowstacks.com/api/skills/adguardhome/claude-skill -o ~/.claude/skills/adguardhome/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How AdGuardHome works

Codeflow

Free to inspect

AdGuardHome is a very large TypeScript project (~132k lines across 1198 code files, plus 88 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, GPL-3.0 license, has a test suite.

Size

Very large codebase

~132k lines · 1198 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

No API keys detected

TypeScript 45%Go 42%CSS 10%Shell 1%JavaScript 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
main.go
Where the program starts running
3
go.mod
Dependencies and the commands it exposes
4
internal/client/index.go
Inside internal/ — the main logic begins here

What's in each folder

internal/Core code — the actual logic538 files

client/Frontend / UI351 files

doc/Documentation4 files

client_v2/Folder770 files

scripts/Helper scripts29 files

docker/Deployment / infrastructure8 files

openapi/Folder5 files

bamboo-specs/Folder4 files

READMEHas testsDocumentedCI checksGPL-3.0 licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/adguardhome && curl -fsSL https://workflowstacks.com/api/skills/adguardhome/claude-skill -o ~/.claude/skills/adguardhome/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

AdguardTeam

Language

TypeScript