WHY I BUILT THIS
I was frustrated with the fragmented tmux status bar ecosystem. Most solutions required cobbling together multiple plugins, each with different configuration styles, no caching, and inconsistent theming. I wanted:
1. One framework with consistent configuration across all plugins 2. Smart caching to avoid hammering system calls every status refresh 3. Semantic colors that work across different themes 4. Conditional display - plugins that hide when not relevant (e.g., VPN only shows when connected)
TECHNICAL HIGHLIGHTS
Intelligent Caching: Every plugin has configurable TTL caching. Results are stored in ~/.cache/tmux-powerkit/ with timestamps. Default TTLs are tuned per-plugin based on data volatility—camera/microphone checks every 1s for privacy, while package updates cache for 1 hour.
Semantic Colors: Instead of hardcoding hex values, plugins use semantic names like 'warning' and 'error'. The active theme resolves these at runtime. Switch themes without reconfiguring plugins.
Threshold-Based Colors: Many plugins support multi-tier thresholds. CPU can turn yellow at 70%, red at 90%.
Conditional Display: Plugins intelligently hide when not relevant: - git: only shows in git repositories - vpn: only shows when connected - network: only shows above configurable traffic threshold - camera: only shows when camera is active - kubernetes: can show only when cluster is reachable
PLUGINS (32+)
System Monitoring: cpu, gpu (NVIDIA/AMD/Intel), memory, disk, loadavg, temperature, fan, uptime, brightness
Network: network (bandwidth), wifi (with signal strength), vpn (WireGuard, OpenVPN, Tailscale, etc.), external_ip, ping, ssh, bluetooth, weather
Development Tools: - git: branch with modified repo detection - kubernetes: context/namespace with interactive fzf selectors - cloud: AWS/GCP/Azure context with production warnings - terraform: workspace with production highlighting, OpenTofu support
Security: smartkey - hardware security key detection (YubiKey, SoloKeys, Nitrokey) with "waiting for touch" indicator
Media & Audio: audiodevices (with device switching popup), microphone (with mute toggle), nowplaying (Spotify, Apple Music, MPRIS), volume, camera (privacy indicator)
Package Managers: packages - unified updates for brew, yay, apt, dnf, pacman
Time: datetime, timezones (multiple zones with aliases like nyc, tokyo, london)
INTERACTIVE KEYBINDINGS
prefix + ? : Browse all PowerKit options prefix + K : Kubernetes context selector prefix + N : Kubernetes namespace selector prefix + W : Terraform workspace selector prefix + J/O : Audio input/output device selector prefix + m : Microphone mute toggle prefix + Q : Clear all caches
EXTERNAL PLUGIN INTEGRATION
Wrap any external tmux plugin with PowerKit's styling using the external() function. Supports custom icons, colors, and cache TTL.
INSTALLATION
set -g @plugin 'fabioluciano/tmux-powerkit'
set -g @powerkit_theme 'tokyo-night'
set -g @powerkit_plugins 'datetime,cpu,memory,git,battery'
Linux: Full support macOS: Full support (some plugins use different backends) BSD: Partial support WSL: Works with Linux-compatible plugins
STACK
Pure shell (bash/zsh compatible). No compiled dependencies. Uses standard Unix tools (df, ps, /proc/*, etc.) with fallbacks per platform.
Themes included: Tokyo Night, Kiribyte. More welcome via PR.
Feedback and contributions welcome. What plugins would be useful for your workflow?