Project

threeman

0.01
Low commit activity in last 3 years
No release in over a year
An alternative to Foreman, which runs each command in a separate tab
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

~> 1.10
>= 0
>= 10.0
>= 0

Runtime

 Project Readme

Threeman

Threeman is an alternative to Foreman. Rather than running all the commands together in one terminal, it opens a tab for each command. The benefits of this are:

  • Your terminal app will notify you using an icon when there's new output from each command
  • Because your command's input and output aren't being intercepted by Foreman, you can use Pry

Threeman also has an extensible architecture to allow it to support multiple terminal apps. Right now, it supports:

  • iTerm 2.9 and above
  • Mac OS X's built-in Terminal app
  • tmux

Installation

Make sure you have a supported terminal app installed.

Run:

$ gem install threeman

Usage

From your app's directory (with a Procfile in it), run:

$ threeman

Threeman will open a new terminal window with each of your Procfile commands running in a separate tab.

Threeman also supports reading a .threeman or .foreman file containing default options in YAML format, just like Foreman does with the .foreman file. For example, a .foreman file containing:

port: 3000

will cause Threeman to run the app with the PORT environment variable set to 3000.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run bundle exec rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org. Remember to also update the CHANGELOG.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/patientslikeme/threeman. Contributors are expected to follow the code of conduct specified in CODE_OF_CONDUCT.md.

License

Threeman is © 2016-2017 PatientsLikeMe, Inc. and is released under the MIT License. See the LICENSE file for more information.