Repository files navigation

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 apairprogramming 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: Ifwemux 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 awemux 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