Fetching contributors…
Cannot retrieve contributors at this time
92 lines (53 sloc) 2.27 KB



  • Ruby 2.1+

  • curses gem

Diakonos is built to run on Linux, but may run under other flavours of UNIX. It is known NOT to work under Windows (unless using Cygwin). It works reasonably well under iTerm on OSX.

Under Debian and Ubuntu derivatives, you'll need the following dependencies:

sudo apt-get install libncurses5-dev ruby-dev
sudo gem install curses


The latest stable tarballs can be acquired from

The latest development code can be obtained from github:

git clone git://


ruby install.rb --help
ruby install.rb [installation parameters]

You may need root privileges on the system in order to install to system-wide places like /usr . However, Diakonos runs perfectly well in userspace, such as under ~/usr .


If you use RVM, note that Diakonos installs very easily into an RVM-based Ruby.

After installing Diakonos under RVM, you can symlink to the installed binary, and that will allow you to use Diakonos with that specific Ruby version no matter what the current RVM Ruby is. Example:

mkdir -p ~/bin
cd ~/bin
ln -s /home/pistos/.rvm/rubies/ruby-1.9.2-p180/bin/diakonos

Then ensure that ~/bin is in your PATH.



diakonos --uninstall


Run with any of these:

diakonos [filename...]
diakonos -s <session-name>
diakonos -m <regexp>

or, for other options and arguments,

diakonos --help

For help using Diakonos, simply press F1 or Shift-F1 from within the editor to use the interactive help system.

To dig deeper into Diakonos' rich feature set, see .

The source code repository is at .


Send comments, feedback and tech support requests to the #mathetes channel on the FreeNode IRC network ( ), or the mailing list . Reproducible issues may be reported at .