Adding in support for the compare command in the API
Adding in support for the refs command and filters in the API
adding some more type-safe overloads
doc improvement