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.

Usage

  1. gem install vines-agent

  2. vines-agent init wonderland.lit

  3. cd wonderland.lit && vines-agent start

Dependencies

  • blather >= 0.5.4

  • eventmachine >= 0.12.10

  • nokogiri >= 1.4.4

  • ruby >= 1.9.2

Ubuntu setup

$ sudo apt-get install build-essential ruby1.9.1 ruby1.9.1-dev libxml2-dev libxslt-dev

Contact

License

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