mrkeyoor.com_
Thu 12 Nov 02:20 UTC
Dev Toolsevaluationupdated 10 Oct 2026

shannon review

Shannon reads a web application's source code and attempts real attacks against its running app and APIs. It reports demonstrated vulnerabilities so developers can inspect evidence before a release.

+383stars / 7d
Verdict

Our Shannon run installed 416 packages in 7 seconds and built in 11 seconds, but supplied no test result or completed pentest. Try it when you can provide source code, disposable staging data, and a reviewer for exploit evidence. Require a completed trial scan before making it a release gate, especially with the current read-only mount report.

We ran it

Lab card: what happened when we ran shannonScreenshot of shannon (keygraph.io)
Install✓ · 7s416 packages · 553 MB
Build✓ · 11s
Testsn/ano test script
Repo370 files~52,029 lines of source · 57.8 MB · 4 CI workflows · Dockerfile

Answers from our run

Does shannon build from source?

Dependencies installed in 7 seconds (416 packages), and the build succeeded in 11 seconds. We cloned commit 2468b67 into a clean Debian container with 3 CPUs and no project-specific setup.

Does shannon have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Who should not use shannon?

Teams testing only an external URL: the open-source edition requires source access, while black-box testing belongs to commercial editions.

What are the alternatives to shannon?

ZAP, Nuclei, Semgrep. Our Shannon run installed 416 packages in 7 seconds and built in 11 seconds, but supplied no test result or completed pentest.

Setup3/5Fast build, then Docker, target access, and model configuration
Docs4/5Specific auth, platform, provider, and scope guidance
Community4/5October activity and 48,722 stars, external contributions closed
Maturity3/5No test target in our run, current scan and report bug reports

Discussed on

  1. hnShannon – Autonomous AI Hacker4 points
  2. hnShannon: Claude Code for Pen Testing: #1 on Github today3 points
  3. hnAutonomous AI hacker to find actual exploits in your web apps3 points

Who it’s for

Developers with source access and a disposable staging application who want evidence of exploitable defects.
Security engineers who can review attack artifacts and configure authenticated access.
Teams adding exploitation-based severity checks to an existing CI workflow.

Who it’s NOT for

Teams testing only an external URL: the open-source edition requires source access, while black-box testing belongs to commercial editions.
Operators restricted to production targets: the safety guide says exploitation can change or delete application data.
Native Windows users unwilling to use WSL2: the platform guide excludes native Windows and Git Bash.
Teams expecting community patch acceptance: the README says external code contributions are currently closed.

Setup reality

Our run at commit 2468b67 installed 416 pnpm packages in 7 seconds, occupying 553 MB, and built successfully in 11 seconds. Tests were skipped because no script or target existed. The 57.8 MB checkout had 370 files, about 52,029 source lines, 4 CI workflows, Docker and compose files, workspace packages, and no tests directory.

A real assessment needs Docker, model-provider credentials or a configured local endpoint, source access, and a reachable target. Authenticated scans need login configuration. Provider safeguards may interrupt cyber workloads, and model requests carry source and application context to your chosen endpoint.

Use disposable staging data because exploits can mutate it. Windows requires WSL2, and Docker needs the right address for host-local apps. Current issue 490 reports a v3.4.0 checkpoint failure on a read-only mount, so verify a complete scan before relying on a release gate.

Shannon earns its place by trying the exploit

Give Shannon a source repository and a running staging application, and it follows suspected weaknesses through to an attempted exploit. Its reporting rule is unusually useful: candidates that it cannot demonstrate do not become pentest findings. For a developer tired of sorting speculative alerts, that is a reason to try it. The cost is that you must supply an application it can actually attack, with accounts and data you can afford to lose.

The distinction matters even after a clean checkout. Our 57.8 MB repository became a 553 MB installation, and the build completed in 11 seconds. Those results establish that the code can be prepared in our environment. They say nothing about whether Shannon can reach your login flow, exploit your application, or finish a report. Adoption starts with an expendable target and a person who can judge the evidence.

What happened when we ran it

Our run installed 416 pnpm packages in 7 seconds and built Shannon in 11 seconds at commit 2468b67. We used a fresh, unprivileged Debian container on October 9, 2026, with 3 CPUs, 8 GB of RAM, the lab-node:22 image, and no secrets. Both steps succeeded. There was no test script or target, so the harness skipped tests rather than recording a pass.

The checkout contained 370 files and roughly 52,029 lines of source. Our scan found 4 CI workflow files, a Dockerfile, a compose file, and workspace packages, but no tests directory. That is enough structure to make a source build approachable. It is weaker evidence for runtime correctness: the measured run supplies no automated test result and no completed assessment against a live target.

Docker and model credentials are part of the job

The quick start launches through npx, requires Docker, and asks you to bring model credentials. The worker runs in an ephemeral container, reads the target source, and writes results into a local workspace. Authenticated assessments add login configuration, potentially TOTP or email authentication, and rules of engagement. You should prepare those inputs before treating the launcher as a ready security service.

Our 7-second installation excludes configuring a provider and a target. Source and application context travel to the model endpoint you choose, even though Keygraph says it neither receives the repository nor proxies those requests. A local model endpoint can keep that traffic inside your environment. Model capability still affects results, and the README warns that provider cyber safeguards can interrupt legitimate work. Confirm your chosen provider's requirements before relying on scheduled scans.

Exploit-only reports leave other security work uncovered

Shannon's scope guide covers injection, cross-site scripting, server-side request forgery, and broken authentication or authorization. The proof requirement gives reviewers something concrete to reproduce. It also excludes weaknesses that the agent cannot actively exploit, including many dependency, configuration, and policy findings. Keep your existing dependency and secret checks. A clean Shannon report answers a narrower question than whether the application is secure.

The 11-second build provides no evidence about coverage or false negatives. The README also reserves black-box testing without source, findings management, and fix pull requests for commercial editions. If your job starts with an external URL and no repository, the open-source edition misses a basic requirement. If you need a repeatable human assessment of business logic, the project itself says expert pentesters still have a role.

An open mount failure deserves a trial before a release gate

Issue 490, updated October 10, reports that Shannon v3.4.0 tries to create a Git checkpoint inside a repository the CLI mounted read-only. The supplied error names an index.lock file and a read-only filesystem. That report concerns the current scan path, not an unrelated component. We did not reproduce it in our build-only sandbox, so its reach across installations remains unconfirmed.

A second current report, issue 485, describes large reports failing during finalization when committed text contains multibyte characters. A proposed fix was still open in the inspected activity. These are reasons to complete a trial assessment and inspect its final artifacts before making Shannon a required gate. Passing compilation with 416 installed packages cannot tell you that the reporting stage will finish.

CI preserves evidence and distinguishes an incomplete scan

The documented GitHub and GitLab integrations preserve reports and scan logs, and can reject a release when an exploited finding reaches your configured severity. Importantly for a buyer, the README distinguishes incomplete assessments from completed scans with no findings. Configure your workflow around that distinction. Otherwise a target-access problem could leave a green-looking result where nobody actually assessed the application.

Our scan found 4 CI workflow files, but did not execute those integrations. Windows users also need WSL2: the platform guide excludes native Windows and Git Bash. Local targets require Docker-aware addressing such as host.docker.internal rather than the host's localhost. That networking step is easy to overlook when the launcher itself starts correctly and the browser agent cannot reach the app.

October activity shows maintenance, with contribution limits

The last push was October 8, 2026. GitHub showed 48,722 stars and 23 open issues and PRs, while the latest release, v3.4.0, shipped October 6 with authentication preflight and report work. Recent bug reports and proposed fixes show active use alongside active maintenance. The README nevertheless says Keygraph is not accepting external code contributions. A large audience does not give you a community route for getting your own patch merged.

Choose ZAP when you want an established web-testing workflow under direct operator control, or Nuclei when template-driven checks fit your target. Shannon deserves a trial when source-informed exploitation is the missing step in your staging process. Budget the 553 MB we measured, then require one completed, reviewable assessment on disposable data before attaching its result to a release decision.

Alternatives

ProjectWhat it isPick it when
ZAPA web application scanner with automated and manual testing workflows.pick this instead when you want direct control over a conventional web-testing session.
Nuclei gh↗A vulnerability scanner driven by reusable templates.pick this instead when defined template checks suit your targets and source access is unavailable.
SemgrepStatic analysis using patterns that resemble source code.pick this instead when you need code checks without running and attacking the application.

What people are saying

  1. [hackernews] Alan Kay: Shannon gave us a way of dealing with noisy channels [video]

Sources

  1. Shannon README
  2. Safety and scope
  3. Platform requirements
  4. Read-only checkpoint report
  5. Report finalization issue
  6. v3.4.0 release

More dev tools reviews

improve · modern-web-guidance-src · folly · universal-android-debloater-next-generation · OpenSandbox · You-Dont-Know-JS · the whole board →