Skip to content

AdGuard Home CLI

Lets an agent manage AdGuard Home ad blocking, DNS rewrites, clients, DHCP and logs from the command line.

Stars
58,084
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent to control an AdGuard Home server, a network-wide ad and tracker blocker that runs on your own network. Instead of clicking through a web interface, the agent can run a command-line tool to check status, add or toggle blocklists, add local DNS names, manage client devices, read query logs and statistics, and set up DHCP leases. The skill tells the agent to use JSON output and to test the connection first.

Great for

  • Home or small-office network administrators who want an AI assistant to handle routine AdGuard Home changes
  • Power users who prefer scripted or terminal workflows over a web GUI
  • Developers building agent workflows that need to read or change DNS filtering settings

Skip it if

  • Anyone without an existing AdGuard Home installation, since the tool only controls a running server and does not replace it
  • Shared or production networks where an agent could change DNS, DHCP or blocking rules without review, which can break connectivity for everyone on the network
  • Users who want to block ads on a single device only, since this manages the network-wide server

Try asking

  • “Check whether AdGuard Home is running and which version is installed”
  • “Add a new blocklist from a URL and refresh all filters”
  • “Create a local DNS rewrite so myserver.local points to 192.168.1.50”
  • “Show the last 50 blocked DNS queries as JSON for review”
Step-by-step guide: how to use AdGuard Home CLIInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    cli-anything-adguardhome.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip cli-anything-adguardhome.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip cli-anything-adguardhome.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run the config test command before any other command so connection problems are caught early.
  • Keep changes like DHCP, restart and filter removal under human confirmation, since mistakes can disrupt the whole network.
  • Use the --json flag when the agent needs to parse results, and check the exit code before trusting output.

What's inside

  • SKILL.md

Redistributed unmodified from HKUDS/CLI-Anything under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.