Wemux::Pair

Firewall-punching remote pairing with wemux made easy

Wemux::Pair allows two users to collaborate within the same terminal session via ssh.

• Have a box that is accessible to both users via ssh.
• wemux should be installed on the host.

Add this line to your application's Gemfile:

gem 'wemux-pair'

And then execute:

$ bundle

Or install it yourself as:

$ gem install wemux-pair

'Host' refers to the computer that initiates the wemux session and 'client' refers to the computer that joins the session.

1. Create a pairprogramming user.

2. Give that user remote login access via System Preferences>Sharing>Remote Login

3. Add client's ssh keys to ~pairprogramming/.ssh/authorized_keys

4. In ~pairprogramming/.bash_profile should be: wemux attach; exit

5. Ensure your user is in the host_list in /usr/local/etc/wemux.conf, e.g.

    host_list=(yourusername)
   

Note: If wemux was installed via Homebrew, the host_list is often misconfigured by default.

Generate .pair.yml configuration, run $ pair --init

Print Usage: $ pair --help

Host: Start a wemux session

Then run $ pair host

Client: Ensure you're not in a wemux/tmux session

Run $ pair <host port>

1. Fork it
2. Create your feature branch (git checkout -b feature/my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin feature/my-new-feature)
5. Create new Pull Request