• tmux 3.0+ (recommended: 3.2+)
• Bash 5.0+ (5.1+ recommended for optimal performance)
• Nerd Font for icons (recommended: JetBrainsMono Nerd Font)

PowerKit uses modern Bash features for optimal performance:

Check your Bash version:

bash --version

Add to your ~/.tmux.conf:

set -g @plugin 'fabioluciano/tmux-powerkit'

Install with prefix + I (capital i).

For faster download (~1.5 MB instead of ~20 MB):

git clone --depth 1 https://github.com/fabioluciano/tmux-powerkit.git ~/.tmux/plugins/tmux-powerkit

If you need the full git history:

git clone https://github.com/fabioluciano/tmux-powerkit.git ~/.tmux/plugins/tmux-powerkit

Download without git (smallest size):

mkdir -p ~/.tmux/plugins
curl -L https://github.com/fabioluciano/tmux-powerkit/archive/refs/heads/main.tar.gz | tar xz -C ~/.tmux/plugins
mv ~/.tmux/plugins/tmux-powerkit-main ~/.tmux/plugins/tmux-powerkit

Add to your ~/.tmux.conf:

run-shell ~/.tmux/plugins/tmux-powerkit/tmux-powerkit.tmux

Reload tmux:

tmux source ~/.tmux.conf

Add to flake.nix:

{
  inputs.tmux-powerkit.url = "github:fabioluciano/tmux-powerkit";
}

Add to configuration.nix or home.nix:

programs.tmux = {
  enable = true;
  plugins = [{
    plugin = inputs.tmux-powerkit.packages.${pkgs.system}.default;
    extraConfig = ''
      set -g @powerkit_plugins "datetime,battery,cpu,memory,git"
      set -g @powerkit_theme "catppuccin"
      set -g @powerkit_theme_variant "mocha"
    '';
  }];
};

For non-flake install, add to your configuration.nix or home.nix:

let
  tmux-powerkit = pkgs.callPackage (pkgs.fetchFromGitHub {
    owner = "fabioluciano";
    repo = "tmux-powerkit";
    rev = "main";  # or pin to a specific commit
    sha256 = "";   # nix will provide correct hash on first build
  } + "/default.nix") {};
in {
  programs.tmux = {
    enable = true;
    plugins = [ tmux-powerkit ];
    extraConfig = ''
      set -g @powerkit_plugins "datetime,battery,cpu,memory,git"
      set -g @powerkit_theme "catppuccin"
      set -g @powerkit_theme_variant "mocha"
    '';
  };
}

After installation, you should see the PowerKit status bar. Press prefix + C-e to open the options viewer and verify the configuration.

PowerKit uses Nerd Font icons. Install a Nerd Font and configure your terminal:

brew tap homebrew/cask-fonts
brew install --cask font-jetbrains-mono-nerd-font

Download from Nerd Fonts and install to ~/.local/share/fonts.

Configure your terminal to use the Nerd Font:

• iTerm2: Preferences → Profiles → Text → Font
• Alacritty: font.normal.family in config
• Kitty: font_family in config

macOS ships with Bash 3.x (due to licensing). Install Bash 5+:

brew install bash

Verify installation:

/opt/homebrew/bin/bash --version  # Apple Silicon
# or
/usr/local/bin/bash --version     # Intel Mac

PowerKit will automatically detect and use the Homebrew version if available.

• Quick Start - Basic configuration
• Configuration - All options
• Themes - Available themes