GitHub Docs

Date: February 2026 Shannon: github.com/KeygraphHQ/shannon — Autonomous AI-powered penetration testing framework VibeCody: AI coding assistant with integrated security testing (Phase 41+)

1. Executive Summary

Shannon is a standalone autonomous pentesting tool (“The Red Team to your vibe-coding Blue team”). VibeCody is a full-stack AI coding assistant that now integrates red teaming capabilities directly into its development workflow. The key difference: Shannon is a separate tool you run after building; VibeCody’s red team module lets you security-test while building, closing the build→test gap.

Dimension Shannon VibeCody
Primary focus Penetration testing AI-assisted development + integrated security
Architecture TypeScript + Temporal + Docker Rust + Tokio + OS sandbox
AI backend Claude (primary), experimental GPT/Gemini 10+ providers (Ollama, Claude, OpenAI, Gemini, Grok, Bedrock, Copilot, Groq, OpenRouter, Azure)
License AGPL-3.0 (Lite) / Commercial (Pro) MIT
Cost per scan ~$50 (Claude Sonnet, 1-1.5 hrs) Per-token (user’s configured provider)
Target users Security teams, pentesters Developers who want security built into their workflow

2. Feature Matrix

2.1 Security Testing Pipeline

Capability Shannon VibeCody (Phase 41) Notes
Autonomous pentest pipeline Yes 5-phase (pre-recon → recon → vuln → exploit → report) Yes 5-stage (recon → analysis → exploitation → validation → report) Both use multi-stage orchestration
Single-command launch Yes ./shannon start URL=<target> REPO=<name> Yes vibecli --redteam <url> or /redteam scan <url> Comparable UX
White-box (source-code-aware) Yes Analyzes repo in ./repos/ Yes Analyzes workspace via codebase index + embeddings VibeCody reuses existing semantic index
Workspace resumability Yes Git commit checkpoints Yes Session resume + /rewind + SQLite persistence VibeCody has richer session management
Parallel vuln agents Yes 5 concurrent Yes Configurable (default 3) via multi-agent orchestrator Both leverage parallel execution
Report generation Yes Markdown pentest report with PoC Yes Markdown report with CVSS scores + PoC + remediation Both produce actionable reports

2.2 Vulnerability Coverage

Vulnerability Type Shannon VibeCody (Phase 41) Detection Method
SQL Injection (CWE-89) Yes Exploit + PoC Yes Static regex + LLM analysis + HTTP validation Shannon validates via browser; VibeCody via HTTP requests
XSS — Reflected (CWE-79) Yes Browser-validated Yes Static regex + LLM + HTTP validation Shannon uses Playwright; VibeCody uses reqwest + browser action
XSS — Stored (CWE-79) Yes Browser-validated Yes LLM analysis + HTTP validation Both require multi-step payloads
SSRF (CWE-918) Yes Active exploitation Yes Static regex + LLM analysis New CWE pattern added
Command Injection (CWE-78) Yes Denylist bypass Yes Static regex + LLM analysis Existing pattern extended
Path Traversal (CWE-22) Yes Yes Static regex + LLM Existing pattern
IDOR (CWE-639) Yes Active exploitation Yes Static regex + LLM analysis New CWE pattern
Auth Bypass Yes JWT manipulation, registration bypass Yes LLM-driven auth flow testing Shannon has deeper auth testing
Mass Assignment Yes Active exploitation Yes LLM analysis Both LLM-powered
XXE (CWE-611) No Not mentioned Yes Static regex pattern VibeCody advantage
Insecure Deserialization (CWE-502) No Not mentioned Yes Static regex pattern VibeCody advantage
NoSQL Injection (CWE-943) No Not mentioned Yes Static regex pattern VibeCody advantage
Template Injection (CWE-1336) No Not mentioned Yes Static regex pattern VibeCody advantage
CSRF (CWE-352) No Not mentioned Yes Static regex pattern VibeCody advantage
Cleartext Transmission (CWE-319) No Not mentioned Yes Static regex pattern VibeCody advantage
Hardcoded Credentials (CWE-798) No Not mentioned Yes Static regex pattern Existing pattern
Insecure RNG (CWE-338) No Not mentioned Yes Static regex pattern Existing pattern
Open Redirect (CWE-601) No Not mentioned Yes Static regex pattern Existing pattern

2.3 Infrastructure & Tooling

Capability Shannon VibeCody Notes
Recon tools (nmap/subfinder/whatweb) Yes Docker containers Warning: HTTP crawling + source analysis Shannon has deeper network recon
Browser automation Yes Playwright (full) Warning: reqwest + screencapture (basic) Shannon has richer browser control
Docker isolation Yes Required No Uses OS sandbox (seatbelt/bwrap) Different isolation models
Temporal durable workflows Yes Crash recovery, queryable No Agent loop + background jobs Shannon more resilient to crashes
Auth flow YAML config Yes 2FA/TOTP/Google SSO Yes AuthFlow struct (URL, creds, selectors) Shannon has broader auth support
MCP server Yes mcp-server/ Yes –mcp-server Both expose MCP interface
CI/CD integration Yes Shannon Pro (commercial) Yes GitHub Actions + –exec mode VibeCody CI is OSS
Progress monitoring Yes ./shannon logs + Temporal UI Yes REPL /redteam show + RedTeamPanel UI Both have live monitoring

2.4 Developer Experience

Capability Shannon VibeCody Notes
Desktop GUI No CLI-only (+ Temporal Web UI) Yes RedTeamPanel.tsx in VibeUI VibeCody has native desktop UI
IDE integration No Yes VS Code, JetBrains, Neovim VibeCody has full IDE ecosystem
REPL commands No Shell script only Yes /redteam with tab-completion VibeCody has interactive REPL
Scheduling No Manual launch Yes /schedule cron integration VibeCody can schedule recurring scans
Notification gateways No Yes Slack/Telegram/Discord/Linear VibeCody can alert on findings
BugBot PR review No Yes Inline GitHub PR comments VibeCody integrates with PR workflow
Multi-provider LLM Warning: Claude primary only Yes 10+ providers VibeCody is provider-agnostic

3. Architectural Comparison

Shannon Architecture

CLI (./shannon) → Docker Compose → Temporal Worker
  └─ 5-Phase Pipeline:
     1. Pre-Recon (nmap, subfinder, whatweb, source analysis)
     2. Recon (attack surface mapping)
     3. Vulnerability Analysis (5 parallel agents)
     4. Exploitation (browser-based, conditional)
     5. Reporting (markdown with PoC)
  └─ AI: Claude Agent SDK (maxTurns: 10,000)
  └─ Storage: audit-logs/ directory, git checkpoints

VibeCody Red Team Architecture

CLI (vibecli --redteam) or REPL (/redteam scan) or VibeUI (RedTeamPanel)
  └─ 5-Stage Pipeline (redteam.rs):
     1. Recon (HTTP crawl + source analysis via codebase index)
     2. Analysis (CWE regex + LLM white-box review)
     3. Exploitation (HTTP validation + browser actions)
     4. Validation (confirm exploitability, generate PoC)
     5. Report (markdown with CVSS + remediation)
  └─ AI: Any of 10+ providers (user-configured)
  └─ Storage: ~/.vibecli/redteam/ JSON + SQLite sessions
  └─ Reuses: bugbot.rs patterns, AgentLoop, multi-agent orchestrator,
             background_agents, session_store, workflow stage patterns

4. When to Use Which

Scenario Recommended Tool Why
Annual professional pentest Shannon Deeper exploitation, browser-validated PoCs, Temporal durability
Security check during development VibeCody Integrated into editor/REPL, runs alongside coding workflow
CI/CD security gate Either Shannon Pro for full pentest; VibeCody --redteam for fast static+LLM scan
PR security review VibeCody BugBot inline comments, CWE pattern matching in diffs
OWASP Juice Shop / CTF Shannon Purpose-built for exploitation with 96% benchmark success
Quick vulnerability scan of WIP code VibeCody /redteam scan localhost:3000 from REPL, instant results
Team notification on findings VibeCody Slack/Telegram/Discord gateways built-in
Scheduled recurring scans VibeCody /schedule cron integration

5. Integration Opportunity

Shannon and VibeCody are complementary, not competing:

  1. VibeCody builds → Shannon validates: Use VibeCody for development, trigger Shannon for deep pentest before release
  2. Shannon MCP → VibeCody MCP: Both expose MCP servers; a meta-orchestrator could chain them
  3. VibeCody’s /redteam for fast feedback during development; Shannon for thorough pre-release security audit
  4. Shared findings format: Both produce markdown reports; findings could feed into VibeCody’s BugBot for tracking

Updated 2026-02-26 — VibeCody Phase 41 (Red Team Module). Shannon analysis based on KeygraphHQ/shannon repository.