Skip to content
This repository has been archived by the owner. It is now read-only.
A modern cssh replacement
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

crussh: a modern cssh replacement

What are this?

For anyone who needs to administrate clusters of many machines, clusterssh has long been a fallback for when the rest of your automation tools aren't working.

crussh aims to be a simple replacement for cssh with the following improvements:

  • Uses a single window to hold multiple terminals.
  • Intelligently tiles terminals to fit available window size.
  • Scrolls available terminals when they don't all fit in-window.
  • Never resizes a terminal smaller than 80x24 characters.
  • Uses GTK and the VTE widget to provide modern, anti-aliased terminals.


The install process is very simple on most distros:

  • Install python3 and python3-gi.
  • Clone and symlink to your bin dir:
git clone
ln -s $(pwd)/crussh/ ~/bin/crussh

Run crussh HOST [HOST ...]


Basic usage is covered via the builtin help, which you can get by running crussh -h. This section covers some common use cases.

To connect to a list of hosts in a file:

crussh $(cat hostlist.txt)

To use a custom login name, public key, or other SSH client options:

crussh -l someuser -i ~/.ssh/myotherkey -- host [host ...]

To do something other than ssh, such as edit a bunch of files in parallel:

crussh -e nano *.txt

Usage Tips

Doing a clustered paste isn't completely obvious. The following methods will work, after making sure you're clicked into the text entry box at the bottom of the window:

  • middle click or shift-insert to paste the X11 selection buffer.
  • control-shift-v to paste the GTK/GNOME clipboard.

Bugs & To Do

To see current issues, report problems, and see plans for features, see the crussh GitHub issues page.

Copyright and License

crussh is copyright 2012-2019 by Tessa Nordgren

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see the GNU licenses page.

You can’t perform that action at this time.