Cli Anything Adguardhome

Name: Cli Anything Adguardhome
Author: hkuds

hkuds/cli-anything

354 installs
46.6k repo stars
Updated August 3, 2026
hkuds/cli-anything

cli-anything-adguardhome is a Python CLI skill that operates AdGuard Home DNS filtering, rewrites, clients, DHCP, and query logs via the AdGuard Home REST API for developers automating homelab or edge network setup.

About

cli-anything-adguardhome is a cli-anything skill from hkuds/cli-anything that exposes AdGuard Home network-wide ad blocking and DNS management through a terminal interface backed by the AdGuard Home REST API. Install with pip install cli-anything-adguardhome when Python is available. The CLI lets agents and power users manage filtering lists, DNS rewrites, client rules, DHCP settings, and query logs without opening the web GUI. Developers reach for cli-anything-adguardhome when automating homelab DNS policy, scripting blocklist updates, or letting coding agents verify AdGuard Home service health during edge network setup.

AdGuard Home CLI patterns
DNS list and rewrite ops
Homelab network automation
Non-interactive command recipes
hkuds/cli-anything skill family

Cli Anything Adguardhome by the numbers

354 all-time installs (skills.sh)
+12 installs in the week ending Aug 2, 2026 (Skillselion tracking)
Ranked #159 of 550 CLI & Terminal skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-adguardhome

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/hkuds/cli-anything/cli-anything-adguardhome.svg)](https://skillselion.com/skills/hkuds/cli-anything/cli-anything-adguardhome)

Installs	354
repo stars	★ 46.6k
Last updated	August 3, 2026
Repository	hkuds/cli-anything ↗

How do you manage AdGuard Home DNS from the terminal?

Operate AdGuard Home DNS filtering from the terminal—lists, rewrites, and service checks—when agents automate homelab or edge network setup.

Who is it for?

Developers operating homelab or edge AdGuard Home instances who need scriptable DNS filtering without the web GUI.

Skip if: Teams without AdGuard Home deployed or environments where DNS must be managed only through cloud provider consoles.

When should I use this skill?

Automating AdGuard Home filtering, rewrites, DHCP, clients, or query log checks from an agent or shell session.

What you get

Updated DNS filter lists, rewrite rules, client policies, DHCP settings, and query log reports via CLI commands.

updated DNS rules
query log output

Files

SKILL.mdMarkdownGitHub ↗

cli-anything-adguardhome

Network-wide ad blocking and DNS management via the AdGuard Home REST API. Designed for AI agents and power users who need to manage filtering, DNS rewrites, clients, DHCP, and query logs without a GUI.

Installation

This CLI is installed as part of the cli-anything-adguardhome package:

pip install cli-anything-adguardhome

Prerequisites:

Python 3.10+
AdGuard Home must be installed and running
Install AdGuard Home: curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Usage

Basic Commands

# Show help
cli-anything-adguardhome --help

# Start interactive REPL mode
cli-anything-adguardhome

# Check server status
cli-anything-adguardhome server status

# Run with JSON output (for agent consumption)
cli-anything-adguardhome --json server status

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

cli-anything-adguardhome
# Enter commands interactively with tab-completion and history

Command Groups

Config

Connection and configuration management.

Command	Description
`show`	Show current connection configuration
`save`	Save connection settings to a config file
`test`	Test the connection to AdGuard Home

Server

Server status and control commands.

Command	Description
`status`	Show server protection status
`version`	Show AdGuard Home version
`restart`	Restart the AdGuard Home server

Filter

DNS filter list management.

Command	Description
`list`	List all configured filter lists
`status`	Show filtering status
`toggle`	Enable or disable filtering globally
`add`	Add a new filter list by URL
`remove`	Remove a filter list
`enable`	Enable a specific filter list
`disable`	Disable a specific filter list
`refresh`	Force-refresh all filter lists

Blocking

Parental control, safe browsing, and safe search settings.

Command	Description
`parental status`	Show parental control status
`parental enable`	Enable parental control
`parental disable`	Disable parental control
`safebrowsing status`	Show safe browsing status
`safebrowsing enable`	Enable safe browsing
`safebrowsing disable`	Disable safe browsing
`safesearch status`	Show safe search status
`safesearch enable`	Enable safe search
`safesearch disable`	Disable safe search

Blocked-Services

Manage blocked internet services.

Command	Description
`list`	List currently blocked services
`set`	Set the list of blocked services

Clients

Client device management.

Command	Description
`list`	List all configured clients
`add`	Add a new client by name and IP
`remove`	Remove a client
`show`	Show details for a specific client

Stats

Query statistics.

Command	Description
`show`	Show DNS query statistics
`reset`	Reset all statistics
`config`	View or update statistics retention interval

Log

DNS query log management.

Command	Description
`show`	Show recent DNS query log entries
`config`	View or update query log settings
`clear`	Clear the query log

Rewrite

DNS rewrite rules.

Command	Description
`list`	List all DNS rewrite rules
`add`	Add a DNS rewrite rule
`remove`	Remove a DNS rewrite rule

DHCP

DHCP server management.

Command	Description
`status`	Show DHCP server status
`leases`	List active DHCP leases
`add-static`	Add a static DHCP lease
`remove-static`	Remove a static DHCP lease

TLS

TLS/HTTPS configuration.

Command	Description
`status`	Show TLS configuration status

Examples

Check Server Status

cli-anything-adguardhome server status
cli-anything-adguardhome server version

Manage Filter Lists

# List current filters
cli-anything-adguardhome filter list

# Add a new blocklist
cli-anything-adguardhome filter add --url https://somehost.com/list.txt --name "My List"

# Refresh all filters
cli-anything-adguardhome filter refresh

DNS Rewrites

# Add a local DNS entry
cli-anything-adguardhome rewrite add --domain "myserver.local" --answer "192.168.1.50"

# List all rewrites
cli-anything-adguardhome rewrite list

Client Management

cli-anything-adguardhome clients add --name "My PC" --ip 192.168.1.100
cli-anything-adguardhome clients list

Query Statistics

# Show stats (human-readable)
cli-anything-adguardhome stats show

# Show stats (JSON for agents)
cli-anything-adguardhome --json stats show

Output Formats

All commands support dual output modes:

Human-readable (default): Tables, colors, formatted text
Machine-readable (--json flag): Structured JSON for agent consumption

# Human output
cli-anything-adguardhome filter list

# JSON output for agents
cli-anything-adguardhome --json filter list

For AI Agents

When using this CLI programmatically:

1. Always use `--json` flag for parseable output 2. Check return codes - 0 for success, non-zero for errors 3. Parse stderr for error messages on failure 4. Use absolute paths for all file operations 5. Test connection first with config test before other commands

More Information

Full documentation: See README.md in the package
Test coverage: See TEST.md in the package
Methodology: See HARNESS.md in the cli-anything-plugin

Version

1.0.0

Related skills

Lark SharedWire Feishu/Lark Open Platform auth, tokens, and shared API helpers into agent-built bots and internal tools.514k

Runcomfy CliLet their coding agent call any RunComfy model from the terminal or scripts without managing separate SDKs.298k30

Skills CliDiscover, install, update, and manage reusable agent capabilities from the open Skillselion ecosystem directly inside their coding agent.270k71

TzstCreate, extract, list, and script `.tzst` / `.tar.zst` archives from the terminal with the right compression, streaming, and conflict flags.267k71

XdropPull files from an Xdrop share URL, decrypt them locally, and land outputs in a chosen directory with optional JSON for automation.266k71

WizardAuthor interactive bash setup wizards that open URLs, capture secrets, write .env upserts, and set GitHub Actions secrets step by step.104k202k

FAQ

How do you install cli-anything-adguardhome?

cli-anything-adguardhome installs via pip install cli-anything-adguardhome as part of the hkuds cli-anything package. Python is required on the host running the CLI against an AdGuard Home REST API endpoint.

What can cli-anything-adguardhome manage?

cli-anything-adguardhome manages AdGuard Home filtering rules, DNS rewrites, client policies, DHCP configuration, and query logs through the AdGuard Home REST API without using the web dashboard.

CLI & Terminalinfradeploy