I’ve made a little Symfony tool for generating CLI usage documentation in Readme files: https://github.com/samwilson/console-readme-generator

So far I’ve not added it to many projects, but will do so. I mostly want to use it as a CI step to help keep Readme docs up to date with changes in Console commands.

Here’s an example of the output: https://github.com/wikimedia/ws-export/#cli-usage