Skip to content

nkcoder/reachr

Repository files navigation

reachr

AWS network reachability & topology tool — a read-only Go CLI that scans AWS and renders an interactive whole-VPC topology, plus a reachability engine that explains what can actually reach what, and why a path is broken.

Status: early development. See DESIGN.md for the v1 design and issue #1 for the slice roadmap.

Commands (planned)

Command Description
reachr scan --region <r> [--profile <p>] [--filter tag:project=X] Read-only scan → immutable topology.json snapshot (the only phase that touches AWS).
reachr render <topology.json> [--format html|dot] Interactive diagram from a snapshot (pure function, no AWS).
reachr explain --from <id> --to <id> --port <n> <topology.json> Path + first blocking hop + honest verdict.
reachr diff <old.json> <new.json> Snapshot diff over time.

Development

Uses Task (brew install go-task) as the task runner.

task           # list available tasks
task build     # build the reachr binary
task test      # run tests
task lint      # golangci-lint

About

A Go CLI that scans AWS (read-only) and produces an interactive whole-topology diagram plus a reachability engine

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors