Project

tmux-cssh

0.0
No commit activity in last 3 years
No release in over 3 years
Cluster-SSH on tmux
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Runtime

~> 2.0
 Project Readme

tmux-cssh-rb

Requirements

  • Ruby 1.9.3 or later
  • tmux

Installing

Install from RubyGems repository

coming soon...

Build gem and install

git clone https://github.com/yshh/tmux-cssh-rb.git path/to/tmux-cssh-rb
cd path/to/tmux-cssh-rb
gem build tmux-cssh.gemspec
gem install tmux-cssh-*.gem

Use Bundler

Write the line below to your Gemfile:

gem 'tmux-cssh', git: 'https://github.com/yshh/tmux-cssh-rb.git'

Usage

% tssh -h
Usage: tssh [options]
    -l, --login USERNAME
    -c, --config FILE
        --ssh SSH_COMMAND
        --ssh_args SSH_ARGUMENTS
        --debug DEBUG_LEVEL
        --panes_per_window NUM

tssh should be executed outside of tmux session.

tssh user@host1 host2 host3

Sync mode

When you type to pane, key strokes are copied to all panes in the window. Use tmux command set-window-option synchronize-panes to disable this mode.

You may want to bind a shortcut key to this command (add the line below to your ~/.tmux.conf)

bind-key g setw synchronize-panes

How to exit

Panes do not close after the ssh session terminates (using set remain-on-exit) so that you can see error messages in the case ssh session terminated unexpectedly by errors such as connection error and authentication failure.

You can close dead panes with tmux commands:

  • kill-pane (closes selected pane; bound to C-b x by default) or
  • kill-window (closes all panes in current window; bound to C-b & by default)

OS limits

Opening many tmux panes hits some OS limits.

  • num of pty
  • max open files

Known issues