0xSteph/pentest-ai-agents
pentest-ai-agents is a GitHub repo providing 50+ Claude Code subagent markdown files that turn Claude into a routed offensive-security assistant, covering recon, web, Active Directory, cloud, mobile, wireless, social engineering, payload crafting (msfvenom/Donut), reverse engineering (Ghidra/JadX/Radare2), C2 tuning (Sliver/Mythic/Havoc/Cobalt Strike), container breakout, and LLM red-teaming (OWASP LLM Top 10, prompt injection, RAG poisoning, MCP abuse). It distinguishes Tier 1 advisory agents from Tier 2 execution-capable agents that enforce a declared-scope guard before running commands, and ships a SQLite findings database, hardened CI validator, and an offline Docker bundle.
What it is
pentest-ai-agents (0xSteph) is a collection of 50 Claude Code subagents that turn Claude into an offensive-security assistant. Each agent carries domain knowledge for a specific area — recon, web, Active Directory, cloud, mobile, wireless, social engineering, payload crafting, reverse engineering, exploit chaining, detection, forensics. It ships as pure agent files (markdown/frontmatter): "no servers, no Python deps." You describe a task in Claude Code and it routes to the right specialist.
How it works
Agents are split into two tiers. Tier 1 (advisory) agents are routable from any task. Tier 2 (execution-capable) agents can run Bash, and each must carry a mandatory _scope-guard.md scope-enforcement block; they live in a separate "offensive operations cluster" and require a declared scope. A hardened, SHA-pinned CI validator checks every agent's frontmatter, enforces the scope-guard on all Tier 2 agents, and smoke-tests the installer. Slash commands include /recommend "task" (routes to an agent + concrete commands) and /agents-for <tag> (filters by domain). A findings DB tracks vulns (v2 adds a tool_used column and CVE/tool indexes).
The offensive coverage is real and specific: c2-operator (Sliver/Mythic/Havoc/Cobalt Strike), container-breakout (Docker/K8s escape, runc/cri-o CVEs, kubelet, RBAC abuse), data-exfiltrator, evasion-specialist, persistence-planner, lateral-movement, opsec-anonymizer (burner infra, source-IP design), llm-redteam (OWASP LLM Top 10, prompt injection, RAG poisoning, MCP abuse), and phishing-operator (Evilginx, GoPhish, dnstwist).
What to do
Primary install is a piped shell script that clones to temp, copies agents to ~/.claude/agents/, and exits (idempotent):
curl -fsSL https://raw.githubusercontent.com/0xSteph/pentest-ai-agents/main/install.sh | bashOr install as a Claude Code plugin:
/plugin marketplace add 0xSteph/pentest-ai-agents
/plugin install pentest-ai-agents@pentest-ai-agentsOptional helpers: install.sh --tools pulls underlying CLIs via apt/brew/pacman + pipx/go/cargo; db/doctor.sh audits which tools are installed per agent; --uninstall removes everything.
Caveats
- The safety model is guardrails, not sandboxing. A
_scope-guard.mdhard-refusal list covers DoS, mass scanning, unattended worms, false-flag operations, and safety-of-life systems — but enforcement is prompt-level, and the page itself notes a scope-guard was recently missing from the Bash-capablecicd-redteamagent until CI caught it. Treat scope enforcement as best-effort. - Evaluate the
curl | bashinstall path against your own supply-chain policy; it fetches and executes code frommainat install time. - Capabilities like
data-exfiltrator,c2-operator, andevasion-specialistare genuinely offensive — this belongs only in authorized, scoped engagements.
Organisations named here
- MS17-010
CVEs named here
- CVE-2019-0708
Technologies named here
- SMB / SMBv1
- pentest-ai-agents
- RDP
- Claude Code
- Sliver
- Mythic
- Havoc
- Cobalt Strike
- Docker
- Kubernetes
- msfvenom
- Donut
- Ghidra
- JADX
- radare2
- Binwalk
- Evilginx
- GoPhish
- dnstwist
- commix
- Routersploit
- cupp
- CeWL
- Mentalist
- Crunch
- hashid
- haiti
- Nmap
- nikto
- sqlmap
- Metasploit Framework
- BloodHound
- CrackMapExec
- nuclei
- Ffuf
- Ollama
- LM Studio
- Pentest-AI
- SharpHound
- Metasploit
- Mimikatz
Techniques named here
- AI attack-surface mapping
- Code auditing
- Cryptographic analysis
- Password auditing
- Database attacks
- Network attacks
- Traffic analysis
- Evasion
- Persistence planning
- Data exfiltration
- SCADA attacks
- IoT pentesting
- Lateral movement
- Container/Kubernetes escape
- C2 beacon profile tuning and redirector design
- Operator OPSEC / anonymization
- LLM red-teaming
- SMBv1 exploitation
- RDP exploitation via BlueKeep
- Payload crafting / shellcode conversion
- Firmware reverse engineering
- Phishing simulation infrastructure setup
- CI/CD red-teaming
- MITRE ATT&CK mapping
Related in Offensive Security