Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A super-clean IRC bot with sandboxed Ruby evaluation, repository watching, and link-logging to del.icio.us
Ruby
Branch: master
Pull request Compare This branch is 1 commit ahead, 5 commits behind evan:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
CHANGELOG
LICENSE
Manifest
README
Rakefile

README

Kirby

A super-clean IRC bot.

== This Fork

This fork is saftied from the \r hack that allows anyone to make kirby send arbitrary commands to the IRCd.
It also limits output to three lines.
svn and delicious support removed.

== License

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

The public certificate for the gem is here[http://rubyforge.org/frs/download.php/25331/evan_weaver-original-public_cert.pem]. 

If you use this software, please {make a donation}[http://blog.evanweaver.com/donate/], or {recommend Evan}[http://www.workingwithrails.com/person/7739-evan-weaver] at Working with Rails.

== Features

* <tt>irb</tt>-like interface
* safe, sandboxed Ruby environment
* svn and git-atom commit watching (removed in this fork)
* silent del.icio.us link saving (removed in this fork)
* tolerable channel fault recovery

Kirby is considered feature-locked. 

== Installation

  git clone git://github.com/tsion/kirby

== Usage

To start a basic Kirby from the command line:

  cd working/directory
  kirby mynick mychannel myserver.org [--options]
  
Logs and repository histories get saved to the working directory.

Available post-parameters are:
<tt>----daemon</tt>:: Daemonize.
<tt>----silent</tt>:: Never speak, even for errors.
<tt>----log</tt>:: Log channel chatter to a file.
<tt>----debug</tt>:: 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[http://rubyforge.org/forum/forum.php?forum_id=13984].

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

== Further resources

* http://blog.evanweaver.com/articles/2007/01/04/kirby-spies-your-svn
* http://blog.evanweaver.com/articles/2007/01/06/kirby-gets-a-del-icio-us-account
* http://blog.evanweaver.com/articles/2007/01/02/a-ruby-eval-bot-for-irc-kirby
Something went wrong with that request. Please try again.