Do these scripts require additional Python dependencies?

No, all scripts in the awf-debug-tools suite use the Python 3.8+ standard library only and require no external packages or pip installs.

Does it work with Docker containers?

Yes, it includes tools like inspect-containers.py and diagnose-awf.py which specifically check the status, health, and logs of the firewall's Docker environment.

Can I use this skill for automated debugging?

Yes, all scripts support a --format json flag, making it easy for AI agents or automated scripts to parse the diagnostic data and take action.

How do I find out why a specific domain is being blocked?

You can use the parse-squid-logs.py script to see all recently blocked domains or the test-domain.py script to check a specific URL and receive a suggested fix.

What is the awf-debug-tools skill?

It is a collection of Python scripts that help users and AI agents debug the awf firewall by simplifying logs, diagnosing container health, and testing domain reachability.

AWF Debug Tools

Name: AWF Debug Tools
Author: github

bygithub

•

分析と監視

Provides a suite of Python-based diagnostic scripts to efficiently troubleshoot, monitor, and manage the awf firewall and its Docker containers.

AWF Debug Tools is a specialized collection of Python scripts designed to streamline the operation and troubleshooting of the awf firewall. By replacing verbose Docker and log outputs with clean, actionable data, these tools help developers and AI agents quickly identify blocked domains, verify container health, and validate network configurations. The scripts support both human-readable tables and machine-parseable JSON, making them ideal for automated debugging workflows and reducing token consumption during AI-assisted development.

主な機能

01Native JSON output support for seamless integration with AI agents and automation

02Domain reachability testing with automated fix suggestions for allowlists

03Automated Squid log parsing to identify and count blocked domains

04Comprehensive system diagnostics for container health and network connectivity

05Concise container inspection with filtered log output and status reporting

0644 GitHub stars

ユースケース

01Automating firewall troubleshooting within AI-driven development workflows

02Identifying why a specific network request is being blocked by the firewall

03Monitoring the health and resource status of firewall-related Docker containers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add github/gh-aw-firewall awf-debug-tools

For use in Claude.ai and ChatGPT

Download Skill