This seems like it would primarily be a CLI tool rather than something that would be used programatically, so I think I'd be strongly inclined to focus on the global/CLI usage scenario in the documentation.