Skip to content
This repository
branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 features
Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rspec
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Guardfile
Octocat-spinner-32 LICENSE
Octocat-spinner-32 Rakefile
Octocat-spinner-32 iv-cli.gemspec


Build status

Infrastructure Visualization. This is the command line interface and core classes for iv, a gem for visualizing cloud infrastructure.


Add this line to your application's Gemfile:

gem 'iv-cli'

And then execute:

$ bundle

Or install it yourself as:

$ gem install iv-cli

Then initialize the config files

$ gem init
$ vim ~/.iv/config


IV is built around a core executable, iv, which gives access to multiple subcommands.


Creates config files in the user's home directory.

$ iv init
Generating config directory in ~/.iv
Generating config file ~/.iv/config.yml


Usage: iv init [options]
    -f, --force                      Overwrite pre-existing config files
    -h, --help                       Show this help message


Lists out all nodes in all of your environments

$ iv nodes
+        status +                  name +      ip +    os +   org +
| 2 minutes ago |  | | my os | demo  |
| 1 minute ago  | | | my os | stage |

$ iv nodes -f csv
1 minutes ago,,,os type,demo
1 hour ago,,,os type,prod

Please note that all nodes should have a NAME and an FQDN registered with your chef server in order for the formatting to work correctly.


Usage: iv nodes [options]
    -f, --formatter          Output formatter. Defaults to 'table'


  • table - Outputs headers as well as pipe-delimited rows
  • csv - Outputs rows as comma-delimited text


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
Something went wrong with that request. Please try again.