Kirby

A super-clean IRC bot.

License

Copyright 2007, 2008 Cloudburst, LLC. Licensed under the AFL 3. See the included LICENSE file.

The public certificate for the gem is here.

If you use this software, please make a donation, or recommend Evan at Working with Rails.

Features

  • irb-like interface

  • safe, sandboxed Ruby environment

  • svn and git-atom commit watching

  • silent del.icio.us link saving

  • tolerable channel fault recovery

Kirby is considered feature-locked.

Installation

sudo gem install kirby

Usage

To start a basic Kirby from the command line:

cd working/directory
kirby mynick mychannel myserver.org [delicious_user] [delicious_pass] [--options]

Logs and repository histories get saved to the working directory.

Available post-parameters are:

----daemon

Daemonize.

----silent

Never speak, even for errors.

----log

Log channel chatter to a file.

----debug

Debug mode.

See the Kirby class for in-channel commands.

Crontab example

You can use a crontask to keep Kirby alive at all times. For example: 

* * * * * bash -c 'cd /working/directory; kirby mynick mychannel irc.freenode.net \ 
--daemon --log --silent &> /dev/null'

Reporting problems

The support forum is here.

Patches and contributions are very welcome. Please note that contributors are required to assign copyright for their additions to Cloudburst, LLC.

Further resources