Apache Commons CLI

Clone this repo:
  1. 0304f59 Add missing @since tag by Benedikt Ritter · 2 years ago trunk
  2. 7d5129c JavaDoc tweaks by Benedikt Ritter · 2 years ago
  3. 5d1d967 CLI-267: Add an addRequiredOption method to Options. Thanks to Ricardo Ribeiro. This also closes #7 from GitHub. by Benedikt Ritter · 2 years ago
  4. afc13c4 CLI-266: HelpFormatter.setOptionComparator(null) doesn't display the values in inserted order. Thank you to Ravi Teja. This also closes #6 from GitHub. by Benedikt Ritter · 2 years, 1 month ago
  5. f6af623 Ignore tests purposely left empty test bodies. Thanks to GitHub user august782. This also closes #5 from GitHub. by Benedikt Ritter · 2 years, 1 month ago

Apache Commons CLI

Apache Commons CLI provides a simple API for presenting, processing and validating a command line interface.


More information can be found on the homepage. The JavaDoc can be browsed. Questions related to the usage of Apache Commons CLI should be posted to the user mailing list.

Where can I get the latest release?

You can download source and binaries from our download page.

Alternatively you can pull it from the central Maven repositories:



We accept PRs via github. The developer mailing list is the main channel of communication for contributors. There are some guidelines which will make applying PRs easier for us:

  • No tabs! Please use spaces for indentation.
  • Respect the code style.
  • Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
  • Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running mvn clean test.

If you plan to contribute on a regular basis, please consider filing a contributor license agreement. You can learn more about contributing via GitHub in our contribution guidelines.


Code is under the Apache Licence v2.


You like Apache Commons CLI? Then donate back to the ASF to support the development.

Additional Resources