zakirkun / guardian-cli
guardian-cli
An enterprise-grade, AI-powered penetration testing automation CLI tool. Orchestrates multiple specialized AI agents (Planner, ToolAgent, Analyst, Reporter) backed by 4 AI providers (OpenAI, Claude, Gemini, OpenRouter) and 19 integrated security tools through YAML-defined workflows. Produces professional Markdown, HTML, or JSON security reports with full evidence capture and traceability.
Preview
1. Project Overview
Guardian (v2.0) is a Python 3.11+ CLI application that automates penetration testing workflows using a multi-agent AI system. It is designed for authorized security assessments only.
guardian-cli/ ├── ai/ # AI provider integrations & prompt templates │ ├── providers/ # base_provider, openai, claude, gemini, openrouter │ └── prompt_templates/ ├── cli/ # CLI entry-point (Typer) & commands │ └── commands/ # init, scan, recon, analyze, report, workflow, ai, models ├── core/ # Multi-agent orchestration engine │ ├── agent.py # BaseAgent │ ├── planner.py # PlannerAgent – decides next test step │ ├── tool_agent.py # ToolAgent – selects & executes tools │ ├── analyst_agent.py # AnalystAgent – interprets tool output │ ├── reporter_agent.py # ReporterAgent – generates final reports │ ├── memory.py # PentestMemory, ToolExecution, Finding dataclasses │ └── workflow.py # WorkflowEngine – top-level orchestrator ├── tools/ # 19 security-tool wrappers (one Python file each) ├── workflows/ # YAML workflow definitions (8 built-in) ├── utils/
SKILL.md