← Back to Skills Marketplace
Pihole Ctl
by
azzar budiyanto
· GitHub ↗
· v1.0.1
708
Downloads
0
Stars
2
Active Installs
2
Versions
Install in OpenClaw
/install pihole-ctl
Description
Manage and monitor local Pi-hole instance. Query FTL database for statistics (blocked ads, top clients) and control service via CLI. Use when user asks "how many ads blocked", "pihole status", or "update gravity".
Usage Guidance
This skill appears to do what it says: query the local Pi-hole FTL DB and call the pihole CLI. Before installing, verify you have python3 and the pihole CLI on the host; the metadata omits these required binaries. Do not grant sudo or add the agent's user to the pihole group unless you trust the skill and the environment — management commands (enable/disable/gravity) need elevated privileges. Because the skill's source/homepage are unknown, inspect the included script (small and readable) yourself; it opens the DB in read-only mode and prints JSON and does not contact external servers. If you want stricter safety, restrict the agent's ability to run privileged commands and only grant read access to /etc/pihole/pihole-FTL.db.
Capability Analysis
Type: OpenClaw Skill
Name: pihole-ctl
Version: 1.0.1
The OpenClaw skill 'pihole-ctl' is designed to manage and monitor a local Pi-hole instance. The `SKILL.md` provides clear, non-manipulative instructions and capabilities. The core script `scripts/query_db.py` safely queries the Pi-hole FTL database using `sqlite3` in read-only mode (`mode=ro`) and employs parameterized queries to prevent SQL injection. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, prompt injection attempts against the agent, or obfuscation. While the `SKILL.md` notes that `pihole` CLI commands require `sudo`, this is a factual statement about the command's requirements, not a malicious instruction, and the script itself does not execute these commands.
Capability Assessment
Purpose & Capability
The skill claims to query the Pi-hole FTL DB and control the pihole CLI. The included script reads /etc/pihole/pihole-FTL.db and returns JSON; management actions are intended to be performed with the system 'pihole' CLI. This is coherent with the description, but the package metadata lists no required binaries even though the SKILL.md and scripts expect python3 and (for management operations) the 'pihole' CLI and appropriate system privileges.
Instruction Scope
Runtime instructions are narrowly scoped: read-only queries of the local /etc/pihole/pihole-FTL.db (script opens DB in read-only mode) and optionally run pihole CLI commands for enable/disable/update. The skill does not instruct the agent to read unrelated files, transmit data to external endpoints, or access credentials.
Install Mechanism
No install spec (instruction-only with a small helper script). No downloads or archive extraction. Minimal on-disk footprint and no installer-based risks.
Credentials
The skill requests no environment variables or credentials. It does require the agent/user to have read access to /etc/pihole/pihole-FTL.db and (for management actions) sudo or membership in the pihole group. These filesystem and privilege needs are proportional to the stated tasks, but the metadata should have declared required binaries (python3 and 'pihole') to avoid surprise.
Persistence & Privilege
The skill is not always-enabled and does not request system-wide persistence. Model invocation is allowed (normal default). Be aware that if the agent is allowed to invoke skills autonomously, this skill could run local pihole commands that require elevated privileges — limit those permissions to trusted contexts.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pihole-ctl - After installation, invoke the skill by name or use
/pihole-ctl - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
pihole-ctl 1.0.1
- Updated SKILL.md to clarify script requirements and permissions.
- Added guidance for database read access and recommended group membership.
- Noted that management commands may require sudo or proper user privileges.
- Improved script description for clearer usage.
v1.0.0
Initial release of pihole-ctl: manage and monitor your local Pi-hole instance from the CLI.
- Query FTL database for ad-blocking statistics (last 24h, top clients, top domains).
- Enable or disable Pi-hole blocking via CLI.
- Update Pi-hole gravity blocklists.
- Audit and identify top blocked domains or chatty clients.
- Includes a Python script for safe database queries.
Metadata
Frequently Asked Questions
What is Pihole Ctl?
Manage and monitor local Pi-hole instance. Query FTL database for statistics (blocked ads, top clients) and control service via CLI. Use when user asks "how many ads blocked", "pihole status", or "update gravity". It is an AI Agent Skill for Claude Code / OpenClaw, with 708 downloads so far.
How do I install Pihole Ctl?
Run "/install pihole-ctl" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Pihole Ctl free?
Yes, Pihole Ctl is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Pihole Ctl support?
Pihole Ctl is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Pihole Ctl?
It is built and maintained by azzar budiyanto (@1999azzar); the current version is v1.0.1.
More Skills