tmux-contrib/tmux-aws

tmux-aws

Display your active AWS profile and region in the tmux status bar — SSO & MFA friendly. Pure data passthrough, you control all styling and parsing.

Dependencies

Required

• aws-cli
• aws-vault (or compatible credential provider)

Optional

• aws-fzf - Enables interactive AWS profile selection
• tmux-fzf - Integrates with unified fzf menu

Installation

Add this plugin to your ~/.tmux.conf:

set -g @plugin 'tmux-contrib/tmux-aws'

And install it by running <prefix + I.

Optional: Interactive Profile Selection

For interactive AWS profile selection, install aws-fzf:

git clone https://github.com/aws-contrib/aws-fzf.git
cd aws-fzf && make install

Once installed, tmux-aws will automatically enable interactive profile selection.

Variables

The plugin exposes the following variable:

@aws-profile