Skip to content

hagihala/tmux-cssh-rb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

cluster-ssh on tmux

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages