How 0xsamaaritan/pandora works
Pandora is a single-organisation exposure-monitoring CLI. The operator supplies organisation identifiers and configuration, chooses a surface or dark run, and Pandora queries the relevant source set, reconciles findings against persistent state, then reports and optionally alerts on new results. The graph preserves the documented source capabilities, including dork customization and secret confirmation. Source integrations are grouped by run mode because the sampled source excerpt is incomplete; their individual registrations and calls cannot all be verified here.
Main entry points: cli.py CLI runner · sources.py Surface sources · model.py Finding model · report.py Report generation
Components 15
Run control
- CLI runner
pandora/cli.py - Startup banner
pandora/banner.py
Exposure sources
- Surface sources
pandora/sources.py - Dark sources
pandora/sources.py - Search dorks
pandora/sources.py - Secret confirmation
pandora/sources.py
Finding tracking
- Finding model
pandora/model.py - Dedupe state
pandora/store.py
Reports and alerts
- Report generation
pandora/report.py
Other components
- Operator
- YAML config
- OSINT and threat indexes
- JSON and Markdown reports
- Webhook and email
- Configured repositories
Connections 18
- Operator → CLI runner: runs
README.md - YAML config → CLI runner: configures
pandora/cli.py - CLI runner → Startup banner: prints
pandora/cli.py - CLI runner → Surface sources: dispatches
pandora/cli.py - CLI runner → Dark sources: dispatches
pandora/cli.py - Surface sources → OSINT and threat indexes: queries
README.md - Dark sources → OSINT and threat indexes: queries
README.md - Surface sources → Search dorks: uses
pandora/sources.py - Surface sources → Secret confirmation: includes
README.md - Secret confirmation → Configured repositories: scans
pandora/sources.py - Surface sources → Finding model: creates
pandora/sources.py - Dark sources → Finding model: creates
pandora/sources.py - CLI runner → Finding model: collects
pandora/cli.py - CLI runner → Dedupe state: reconciles
pandora/cli.py - Dedupe state → Finding model: keys and restores
pandora/store.py - CLI runner → Report generation: writes and summarizes
pandora/cli.py - Report generation → JSON and Markdown reports: writes
pandora/report.py - Report generation → Webhook and email: notifies
pandora/report.py