How alimousavisoft/sondra works
sondra is a Go recon and attack-surface monitoring CLI. Users choose a scan or monitor configuration (interactively or headlessly); the runner executes selected recon stages, writes artifacts, generates an HTML report, and can notify on results or changes. Separate command paths provide report/diff and Telegram/Discord bot control. The graph follows documented capabilities and sampled runner wiring; some module implementations and bot-to-runner calls were not excerpted, so those links are marked unverified where included.
Main entry points: runner.go Pipeline runner · main.go CLI commands · handlers.go Control bot · html.go HTML report
Components 25
Command and configuration
- CLI commands
cmd/sondra/main.go - Scan configuration
internal/config/config.go - Module selector
internal/tui/selector.go
Recon pipeline
- Pipeline runner
internal/runner/runner.go - Subdomain enumeration
internal/modules/enum.go - Active brute force
internal/modules/brute.go - DNS resolution
internal/modules/resolve.go - HTTP probing
internal/modules/probe.go - Port scanning
internal/modules/vuln.go - URL collection
internal/modules/vuln.go - JavaScript analysis
internal/modules/jsanalysis.go - Host screenshots
internal/modules/vuln.go - Vulnerability scanning
internal/modules/vuln.go
Results and delivery
- Run artifacts
- HTML report
internal/report/html.go - Run comparison
internal/report/diff.go - Result notifications
internal/runner/notify.go - Notification channels
internal/notify/notify.go
Bot control
- Control bot
internal/bot/handlers.go - Telegram transport
internal/bot/telegram.go - Discord transport
internal/bot/discord.go - Persisted monitors
internal/bot/store.go
Other components
- Operator
- Bot user
- Recon tools
Connections 30
- Operator → CLI commands: runs commands
README.md - CLI commands → Scan configuration: loads settings
- CLI commands → Module selector: opens selector
cmd/sondra/main.go - CLI commands → Pipeline runner: starts scans
cmd/sondra/main.go - Pipeline runner → Subdomain enumeration: runs enumeration
internal/runner/runner.go - Pipeline runner → Active brute force: runs brute force
internal/runner/runner.go - Pipeline runner → DNS resolution: runs resolution
internal/runner/runner.go - Pipeline runner → HTTP probing: runs probing
internal/runner/runner.go - Pipeline runner → Port scanning: runs port scan
- Pipeline runner → URL collection: runs URL collection
- Pipeline runner → JavaScript analysis: runs JS analysis
- Pipeline runner → Host screenshots: runs screenshots
internal/runner/runner.go - Pipeline runner → Vulnerability scanning: runs vuln phase
- Subdomain enumeration → Run artifacts: writes subdomains
internal/modules/enum.go - Pipeline runner → HTML report: generates report
- HTML report → Run artifacts: reads run data
internal/report/html.go - CLI commands → Run comparison: runs diff
cmd/sondra/main.go - Run comparison → Run artifacts: compares runs
- Pipeline runner → Result notifications: dispatches alerts
- Result notifications → Notification channels: sends messages
internal/runner/notify.go - Notification channels → Recon tools: uses configured channels
- CLI commands → Control bot: starts bot
cmd/sondra/main.go - Bot user → Telegram transport: sends commands
README.md - Bot user → Discord transport: sends commands
README.md - Telegram transport → Control bot: dispatches commands
- Discord transport → Control bot: dispatches commands
internal/bot/discord.go - Control bot → Pipeline runner: starts scans
- Control bot → Persisted monitors: persists monitors
internal/bot/handlers.go - Control bot → HTML report: requests report
internal/bot/handlers.go - Pipeline runner → Recon tools: orchestrates recon tools
README.md