Clone or download
Latest commit bb1233c Dec 13, 2011
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin clean up old terminitor stuff Oct 10, 2011
lib version bump 1.0.2 Nov 21, 2011
spec add create command for CLI closes #1 Oct 26, 2011
.gitignore add Gemfile.lock to ignore Oct 10, 2011
Gemfile initial commit Sep 14, 2010
LICENSE add MIT LICENSE Feb 23, 2011 Update Dec 13, 2011
Rakefile clean up old terminitor stuff Oct 10, 2011
Termfile clean up Termfile Dec 6, 2010
consular.gemspec more clean up Oct 10, 2011
spec.watchr add watchr Oct 9, 2011


Consular automates your development workflow setup.

Read the rest of the README and check out the wiki for more info!

Setup && Installation

Install the consular gem and init:

$ gem install consular
$ consular init

This will generate a global path directory for your scripts to live in at ~/.config/consular and also a .consularc in your home directory. You can customize your Consular further with .consularc. Say for example, that you didn't like the default global path:

# ~/.consularc

Consular.configure do |c|
  c.global_path = '/a/path/i/like/better'


After that, you'll need to install a 'core' so you can run Consular n your desired platform.


Cores allow Consular to operate on a variety of platforms. They abstract the general behavior that consular needs to run the commands. Each core inherits from (Consular::Core) and defines the needed methods. Some of the cores that are available are:

  • OSX - Mac OS X Terminal
  • iTerm - Mac OS X iTerm
  • Terminator - Terminator
  • Gnome - Gnome Terminal
  • Gnome - Gnome Terminal Core that doesn't use xdotool

Feel free to contribute more cores so that Consular can support your terminal of choice :)

To integrate core support for your Consular, you can simply require it in your .consularc like so:

# .consularc
require 'consular/osx'

Or check the README of each individual core.

Development Setup

To begin development on Consular, run bundler:

$ gem install bundler
$ bundle install

The test suite uses Minitest to run the test run:

$ rake test

or use watchr:

$ watchr spec.watchr

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


Copyright (c) (2011 - when the Singularity occurs) Arthur Chiu. See LICENSE for details.