# keygraphhq/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.

Source: https://github.com/keygraphhq/shannon
Indexed: commit 00e5645 on 2026-07-06 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: TypeScript
- Stars: 51,924 at index time
- License: AGPL-3.0
- Code health: 6.7/10, Fair
- Last commit: 2026-07-04

## Install

From the README: https://github.com/keygraphhq/shannon#quick-start

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

## How it 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.

- apps/cli/src/commands/start.ts: entry point
- apps/cli/src/index.ts: entry point
- apps/worker/src/audit/index.ts: entry point
- apps/worker/src/interfaces/index.ts: entry point
- apps/worker/src/scripts/generate-totp.ts: entry point
Modules: apps, root, docs, .github, .claude, sample-reports. 135 files, 17,909 lines, 816 symbols.

## Code health

- Score: 6.7/10 (Fair)
- Rank: #173 of 4,000+ indexed repos
- Hotspots: apps/worker/src/temporal/activities.ts, apps/worker/src/services/preflight.ts, apps/cli/src/docker.ts, apps/cli/src/commands/start.ts, apps/cli/src/commands/setup.ts
- Lowest file: apps/worker/src/temporal/activities.ts
- Dead code: 32 findings

## Maintenance

- Last commit 2026-07-04
- bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/keygraphhq/shannon/security

## More

- Page: https://repowise.dev/repo/keygraphhq/shannon
- Ask this codebase: https://repowise.dev/repo/keygraphhq/shannon/chat
- Docs: https://repowise.dev/repo/keygraphhq/shannon/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/keygraphhq/shannon
