Currently provides a simple, easy to use command line tool for sending a message to a HipChat room. Similar to https://github.com/hipchat/hipchat-cli, but about a billion times more Ruby.

Install the gem:

gem install hipchat-cli

Use the bin:

hipchat_notify --room [Room Name] --token [API TOKEN] Hello World!

or

echo "Hello World" | hipchat_notify --room [Room Name] --token [API TOKEN]

-t, --token API_TOKEN            [required] The API token for HipChat
-r, --room ROOM                  [required] The room ID to receive the message
-u, --user USERNAME              The name of the sender. Default: API Client
-f, --format FORMAT              The format of the message. Default: html
-c, --color COLOR                message color: "red", "yellow", "green", "purple" or "random" (default "yellow")
-n, --notify                     notify the users in the room about the message
-h, --help                       Show the options and sample usage

You can use Environment Variables to set common values instead of passing them in via the command line options.

• username: HIPCHAT_API_USERNAME
• room: HIPCHAT_API_ROOM
• token: HIPCHAT_API_TOKEN

It would be awesome to have more commands added to this tool, either as a command or as a standalone bin. If you want to add one, please follow the contribution guidelines below.

Some ideas:

• create a room
• update a topic
• create a user
• delete a user

.. pretty much anything the HipChat API supports. 👍

1. Check master to make sure your idea hasn't already been created
2. Fork the repo
3. Add your changes. Make sure the tests pass (if any)
4. Submit a pull request.

Copyright (c) 2013 Jeremy Baker. See LICENSE for details