cli-anything-adguardhome

Name: cli-anything-adguardhome
Author: hkuds

github.com/hkudsCloud & DevOps57.6k479 installsUpdated 5w ago

About cli-anything-adguardhome

A CLI for AI agents and power users to manage AdGuard Home through its REST API. It covers filtering, DNS, clients, DHCP, and query logs without a GUI.

Key features

01Check server status and version
02Manage DNS filter lists
03Configure parental and safe browsing controls
04Manage clients and DNS rewrites
05View DHCP leases and query statistics
06Inspect and clear query logs

Use cases

01Add or refresh network filter lists
02Create local DNS rewrite rules
03Review DNS queries and statistics
04Manage client devices and DHCP leases

Install

Copy the command and run it in a terminal.

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

After installing, type/cli-anything-adguardhomein Claude Code to confirm it loaded.

Details

From the project README

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:

Always use --json flag for parseable output
Check return codes - 0 for success, non-zero for errors
Parse stderr for error messages on failure
Use absolute paths for all file operations
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

Comments

Markdown supported

Details

Author: hkuds
Repository: hkuds/cli-anything
Category: Cloud & DevOps
Installs: 479
GitHub stars: 57,583

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.