A TPM plugin to show uptime in the tmux status bar
Switch branches/tags
Nothing to show
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.



Display load average in tmux status bar.


  • macOS
  • Linux
  • FreeBSD


Via TPM (recommended)

The easiest way to install tmux-loadavg is via the Tmux Plugin Manager.

  1. Add plugin to the list of TPM plugins in .tmux.conf:

    set -g @plugin 'jamesoff/tmux-loadavg'
  2. Use prefixI to install tmux-loadavg.

  3. When you want to update tmux-loadavg use prefixU.

Manual Installation

  1. Clone the repository

    $ git clone https://github.com/jamesoff/tmux-loadavg ~/clone/path
  2. Add this line to the bottom of .tmux.conf

    run-shell ~/clone/path/tmux-loadavg.tmux
  3. Reload the tmux environment

    # type this inside tmux
    $ tmux source-file ~/.tmux.conf


Edit your status-left or status-right setting to include one of:

  • #{load_short} - display the 1min load average
  • #{load_full} - display the 1min, 5min and 15min load averages

The values are coloured green, orange or red depending on how they compare to the number of CPUs you have.

For example in .tmux.conf:

# display 1min load average and hostname on right of status bar
set -g status-right " #{load_short} #h"

Reload your configuration for it to take effect: prefix-R with TPM, or

$ tmux source-file ~/.tmux.conf