Human-in-the-loop agentic AI CLI for penetration testers that runs recon, validation, and evidence-backed reporting in the terminal.
zakirkun/guardian-cli
A Python CLI that uses LLMs such as Google Gemini, OpenAI, and Claude to orchestrate penetration-testing workflows around established security tools like nmap and nuclei.
- Estrellas
- 1,895
- Forks
- 368
- Issues abiertos
- 5
- Último commit
- hace 4 meses
¿Qué es?
Guardian is a command-line framework for automating penetration tests. An AI agent plans the testing steps, selects which security tools to run, and analyzes their output, while every tool execution is recorded so each finding can be traced back to the command that produced it.
It supports several AI providers, including OpenAI, Claude, Gemini, OpenRouter, Requesty, Ollama, and OpenAI-compatible endpoints. The project ships about 50 tool wrappers covering network scanning, web reconnaissance, subdomain discovery, vulnerability scanning, SSL/TLS testing, cloud and container audits, and Active Directory and Android assessments. Workflows are defined in YAML as a dependency graph, and steps can run in parallel and resume after interruption.
Reports can be generated as Markdown, HTML, or JSON, and findings can be exported as SARIF, to DefectDojo, or to Slack. The tool includes scope validation, a confirmation gate for intrusive tools, and redaction of API keys in logs. Guardian is intended only for systems the user is authorized to test.
Funciones clave
- 01Multi-provider AI planning and tool selection, including Gemini, OpenAI, Claude, and local Ollama models.
- 02About 50 wrapped security tools across network, web, cloud, and mobile categories.
- 03YAML workflows with dependency-based parallel execution and resume support.
- 04Evidence capture that links each finding to its source tool execution.
- 05Report export in Markdown, HTML, JSON, and SARIF, plus DefectDojo and Slack integrations.
- 06Scope validation and a confirmation gate for intrusive tools.
Casos de uso
- Running a repeatable reconnaissance and web vulnerability scan against systems you are authorized to test.
- Producing structured pentest reports with evidence and export to issue trackers or SARIF-based code scanning.
- Experimenting with LLM-driven security automation using a local model via Ollama.
Temas
Preguntas frecuentes
- ¿Qué es guardian-cli?
- A Python CLI that uses LLMs such as Google Gemini, OpenAI, and Claude to orchestrate penetration-testing workflows around established security tools like nmap and nuclei. Guardian is a command-line framework for automating penetration tests. An AI agent plans the testing steps, selects which security tools to run, and analyzes their output, while every tool execution is recorded so each finding can be traced back to the command that produced it.
- ¿guardian-cli es gratuito? ¿Qué licencia tiene?
- guardian-cli es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿guardian-cli sigue mantenido?
- Actualizado en los últimos 6 meses. El último commit de guardian-cli fue el 27 jun 2026.
- ¿Para qué puedo usar guardian-cli?
- Running a repeatable reconnaissance and web vulnerability scan against systems you are authorized to test. Producing structured pentest reports with evidence and export to issue trackers or SARIF-based code scanning. Experimenting with LLM-driven security automation using a local model via Ollama.
- ¿Dónde consigo guardian-cli?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/zakirkun/guardian-cli
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
A CLI and TypeScript SDK from OpenAI for scanning code for security vulnerabilities, validating findings, and generating fixes.
A terminal-based AI pentesting agent that runs security tools, tracks engagement state, and coordinates specialist subagents.
A Python CLI that automatically locks your desktop when your paired Bluetooth phone or smartwatch moves out of range.
Una CLI y una capa de skills que instalan, configuran y verifican canales para que los agentes de IA puedan leer y buscar en Twitter, Reddit, YouTube, Bilibili, XiaoHongShu y más.
Kit de herramientas que genera interfaces de línea de comandos nativas para agentes a partir de software existente e incluye CLI-Hub, un registro para instalar CLIs listas para usar.