An XMPP bot that runs shell commands on remote machines.
Ruby Shell
Latest commit fcb40fd Jun 24, 2013 @dgraham dgraham Update copyright year.
Failed to load latest commit information.
bin Add executable permissions. Jun 20, 2013
conf Initial commit. Sep 28, 2011
lib/vines Bump version to 0.1.4. Jun 21, 2013
script Add test script. Jun 20, 2013
test Remove custom test loader. Jun 20, 2013
.gitignore Ignore bundler. Jun 20, 2013
Gemfile Add gemspec. Jun 21, 2013
LICENSE Update copyright year. Jun 24, 2013 Update markdown readme. Jun 21, 2013
Rakefile Use gem build. Jun 21, 2013
vines-agent.gemspec Add gemspec. Jun 21, 2013

Welcome to Vines Agent

Vines Agent executes shell commands sent by users on remote machines. Users are authorized against an access control list before being allowed to run commands. The agent is an XMPP bot that connects to the Vines chat server. It relies on the component provided by the vines-services gem to send and receive commands.

Users may run commands as any unix account, to which they've been granted access, on the system. While the agent runs as root, user commands run as less privileged accounts.

Additional documentation can be found at


$ gem install vines-agent
$ vines-agent init wonderland.lit
$ cd wonderland.lit && vines-agent start


Vines Agent requires Ruby 1.9.3 or better. Instructions for installing the needed OS packages, as well as Ruby itself, are available at


$ script/bootstrap
$ script/tests



Vines Agent is released under the MIT license. Check the LICENSE file for details.