Shannon is now available via npx (beta)

[ezl-keygraph]

You can now run Shannon directly with npx @keygraph/shannon@beta without cloning the repository or building the Docker image locally.

Beta is currently being tracked in the feat/npx-integration branch

npx @keygraph/shannon@beta setup
npx @keygraph/shannon@beta start -u https://your-app.com/ -r /path/to/your-repo

• Interactive TUI setup wizard - setup guides you through configuring your AI provider credentials, including Claude Direct, Claude via AWS Bedrock, Claude via Google Vertex AI, or a custom Anthropic-compatible endpoint such as proxies and gateways.

• No clone and build required - When you run start, Shannon pulls the worker image from Docker Hub and launches an ephemeral container for the scan. The pipeline and results remain the same as the local workflow. Results are stored in ~/.shannon/workspaces/.

• Isolated execution - Each scan runs in its own worker container with a dedicated task queue.

• Flexible path handling - Repositories and config files can be passed as absolute or relative paths, such as -r /path/to/repo and -c ./my-config.yaml.

All existing functionality continues to work in both workflows: npx and local clone.

This is a beta release. If you run into any issues, please report them on GitHub