Skip to content

Next-gen CLI tool for foreman


Notifications You must be signed in to change notification settings


Repository files navigation

Hammer - the CLI tool (not only) for Foreman

Hammer is a generic clamp-based CLI framework. Hammer-cli provides just the core functionality. The core is extensible using plugins that contain application-specific commands.

This architecture allows for easy customization according to your application. Nearly any Ruby script can be turned into a Hammer command, so the possibilities are endless. You also can easily add custom commands for your specific use, such as bulk actions or admin tasks.

Available plugins are listed on the Foreman's wiki.

Check out the release notes to see what's new in the latest version.


We build rpms, debs and gems. Alternatively you can install hammer from a git checkout. See our installation and configuration instuctions.

Having issues?

If one of hammer commands doesn't work as you would expect, you can run hammer -d ... to get full debug output from the loggers. It should give you an idea what went wrong.

If you have questions, don't hesitate to contact us on or the Freenode#theforeman IRC channel.

Further reading

If you're interested in hammer and want to develop some plugins for Foreman or use it as a base for your own CLI, read the developer docs.


This project is licensed under the GPLv3+.


Thanks to Brian Gupta for the initial work and a great name.