repowiserepowise

App

keygraphhq / shannon

Shannon is an autonomous, white-box AI pentester for web applications and APIs. It analyzes your source code, identifies attack vectors, and executes real exploits to prove vulnerabilities before they reach production.

★ 51,924stars on GitHubTypeScriptAGPL-3.0

This connects Repowise to keygraphhq/shannon's code. It does not install shannon.

Repowise maps public repos from their source. Not affiliated with keygraphhq. What is Repowise?

github.com/keygraphhq/shannonIndexed at 00e5645

What is shannon?

shannon is an autonomous, white-box AI pentester for web applications and APIs. It reads the application's source code to identify likely attack paths, then runs real exploits against the running application and reports only vulnerabilities that have a working proof-of-concept. It is a command-line agent written mainly in TypeScript. To install it, run npx @keygraph/shannon setup. Its code health is 6.7 out of 10 (Fair), ranked #173 of 4,000+ indexed repos. The last commit to shannon was on Jul 4, 2026.

As of commit 00e5645, indexed Jul 6, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.

For agentsshannon.md

Repo facts: type, license, health, rank, contributors
shannon facts
TypeApp
LicenseAGPL-3.0
Code health6.7 / 10 (Fair)
Health rank#173 of 4,000+ indexed repos
Last commitJul 4, 2026
Bus factor1
Size135 files, 17,909 lines

Install shannon

Commands copied from the README

  1. 1Run the interactive setup wizard to configure AI provider credentials.
    npx @keygraph/shannon setup

Releases on GitHub (latest v3.6.1, Nov 20, 2026)

Full install notes on GitHub

Explore shannon

Ask about this code in your agent

This connects Repowise to shannon's code. It does not install shannon. To install shannon, use the install steps.

Useful if you want to change or fork shannon: your agent can ask how it is put together and get answers that cite its files.

Ask about shannon

Answers come from shannon's README and source, with the files they cite. Two free answers a day without an account.

Want this for your own codebase? Map your repo free

About this page

Get a page like this for your own codebase

Repowise built this map of keygraphhq/shannon from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Free for 2 public repos, with a page like this one. No card. See how Repowise works

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub

keygraphhq/shannon FAQ

What is shannon?

shannon is an autonomous, white-box AI pentester for web applications and APIs. It combines source-code analysis with live exploitation to test a running application. It is run from the command line on your own machine.

How does shannon work?

shannon analyzes the source code to find potential attack vectors, then uses browser automation and command-line tools to attempt real exploits. Exploitation attempts that cannot be proven are discarded. The final report contains only validated findings with evidence and remediation guidance.

How do I install shannon?

shannon is run with npx, and the README recommends first running the setup command to configure AI provider credentials. Docker is required for the worker container, and Node.js 18 or newer is required for the npx workflow. See the install steps

What language is shannon written in?

shannon is written mainly in TypeScript, with 93 of its 135 files in that language. The repository also includes one Dockerfile, one JavaScript file and one shell script.

How is the shannon code organized?

shannon keeps most of its code in the apps directory, which is split into apps/cli for the command-line interface and apps/worker for the code that runs scans. The worker uses Temporal, and the CLI manages Docker and the start and setup commands.

What license does shannon use?

shannon is released under the AGPL-3.0 license. The license identifier is AGPL-3.0 as recorded in the repository metadata.

Code health

6.6out of 10Fair

Hotspots average 3.7, the place fixes pay off most.

On the leaderboards:#55 of 70 TypeScript repos

Key features of shannon

  • Reports include validated findings with reproducible proof-of-concept steps instead of speculative warnings.
  • Source-code analysis guides dynamic testing toward realistic attack paths.
  • A single command runs reconnaissance, vulnerability analysis, exploitation, and report generation.
  • Configuration files can describe login flows, test credentials, TOTP, focus areas, and rules of engagement for authenticated testing.
  • Interrupted runs can be resumed without re-running agents that already completed.

How keygraphhq/shannon works

The command-line entry point apps/cli/src/index.ts loads the commands in apps/cli/src/commands, and apps/cli/src/commands/start.ts handles a scan run. apps/cli/src/docker.ts manages the Docker setup that the scan depends on. The scan work runs in a worker, whose steps are defined in apps/worker/src/temporal/activities.ts and whose pre-run checks are in apps/worker/src/services/preflight.ts. According to the README, the target repository is mounted read-only inside an ephemeral worker container, and results are written to a local workspace.

The codebase has 135 files and 816 symbols in 2 modules, led by TypeScript, Dockerfile and JavaScript. Code health is 6.6 out of 10, rated fair.