Agent skill
cli-anything-adguardhome
Command-line interface for AdGuard Home - Network-wide ad blocking and DNS management via 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.
Install this agent skill to your Project
npx add-skill https://github.com/HKUDS/CLI-Anything/tree/main/adguardhome/agent-harness/cli_anything/adguardhome/skills
SKILL.md
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 (
--jsonflag): 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
--jsonflag 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 testbefore 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
HKUDS/CLI-Anything
cli-anything-sts2
Command-line interface for Slay the Spire 2 - Control the real game through a local bridge mod HTTP API. Reads normalized game state and sends action commands for combat, navigation, rewards, and menu management.
HKUDS/CLI-Anything
musescore
CLI for music notation — transpose, export PDF/audio/MIDI, extract parts, manage instruments
HKUDS/CLI-Anything
cli-anything-videocaptioner
AI-powered video captioning — transcribe speech, optimize/translate subtitles, burn into video with beautiful customizable styles (ASS outline or rounded background). Free ASR and translation included.
HKUDS/CLI-Anything
cli-anything-openscreen
Command-line interface for Openscreen — a screen recording editor. A stateful CLI for editing screen recordings with zoom, speed ramps, trim, crop, annotations, and polished exports. Built on the Openscreen JSON project format with ffmpeg as the rendering backend. Designed for AI agents and power users who need programmatic video editing.
HKUDS/CLI-Anything
cli-anything-intelwatch
Zero friction. Full context. Competitive intelligence, M&A due diligence, and OSINT directly from your terminal. Uses Node.js/npx.
HKUDS/CLI-Anything
cli-anything-kdenlive
Command-line interface for Kdenlive - A stateful command-line interface for video editing, following the same patterns as the Blender CLI ...
Didn't find tool you were looking for?