This seems far more granular than what I tend to want to do. For my purposes, Align by Faces (also an addon), is mostly what I need.
When that doesn’t work, or I need more, more control, (and it looks like, with more control, comes more complexity), Mesh Align Plus would be my goto tool.
Seems confusing because “mesh” can be a vertex (vertices), a face (faces), or an edge (edges). And as such, maybe it’s me, your tool seems a little unclear in that regard.
Looking at how vertices align based on the examples I’ve seen here, wasn’t what I was expecting.
Align by Faces was what I was thinking would happen.
Seems, like some extra mental effort is involved if “Align by Faces” is what’s preferred.
Again, maybe I missed it. I didn’t quite see a clear, straightforward example of that.
Other than that, looks quite powerful and versatile as long as you understand how it works and why.
Looks like there’s more info (and gifs) on this at your GitHub.
Helps to spell it out a little more clearly.
To be clear (since there is more than one location), here’s where I found my answer: