Install
pip install aetherscope
Features
Scope parsing
Exact hosts, wildcard domains, negations, host:port, URL rules with scheme and path, IPs, and CIDR ranges. Comments and blank lines ignored.
Negation wins
An out-of-scope rule overrides any inclusion. If a
target is explicitly denied, it is denied — no ambiguity.
Pipe friendly
Feed a subdomain list on stdin, keep only in-scope entries on stdout. Composable with anything.
Exit codes
0 in-scope, 1 out-of-scope,
2 unknown, 3 error. Script-friendly
gatekeeping.
Reports
JSON and Markdown reports with a per-target verdict and the matched rule. Your testing record, versioned.
Zero deps
Pure standard library, Python 3.8+. Install anywhere, run anywhere.
Usage
# classify targets
aetherscope -s scope.txt check api.example.com admin.example.com
# keep only in-scope targets from a list
cat recon_subs.txt | aetherscope -s scope.txt filter > in_scope.txt
# show parsed rules
aetherscope -s scope.txt parse
# build a markdown report
aetherscope -s scope.txt report --format markdown -o report.md
Example report
$ cat scope.txt
*.example.com
!secret.example.com
10.0.0.0/24
$ printf 'api.example.com\nexternal.net\n' | aetherscope -s scope.txt filter
api.example.com