PowerKit includes 45 native plugins plus support for external plugins that allow you to add custom content from shell commands.

# Enable plugins (comma-separated)
set -g @powerkit_plugins "datetime,battery,cpu,memory,hostname,git"

Plugins for monitoring system resources and hardware status.

Plugins for network monitoring and connectivity status.

Plugins for media playback and audio control.

Plugins for development tools and services.

Plugins for time management and productivity.

Plugins for financial data monitoring.

• brightness - Screen brightness (sysfs/brightnessctl/light/xbacklight)

These plugins work on both macOS and Linux. On macOS, they require native binaries (downloaded on-demand):

These plugins use different tools on each platform:

All other plugins work identically on both macOS and Linux.

External plugins allow you to add custom content to the status bar using shell commands. They integrate seamlessly with native plugins and support full theming.

external("icon"|"content"|"accent"|"accent_icon"|"ttl")

You can use any of these color values:

• Theme colors: ok-base, info-base, warning-base, error-base, window-active-base
• Color variants: ok-base-lighter, info-base-darker, window-active-base-lightest, etc.
• Hex colors: "#7aa2f7", "#bb9af7", "#f7768e"

# Show current user with green background
external(""|"$(whoami)"|"ok-base"|"ok-base-lighter"|"3600")

# Show uptime with blue background
external("󰔟"|"$(uptime -p | sed 's/up //')"|"info-base"|"info-base-lighter"|"60")

# Static message with purple background
external("󰍡"|"Production"|"window-active-base"|"window-active-base-lighter"|"0")

# Git branch (alternative to git plugin)
external(""|"$(git branch --show-current 2>/dev/null || echo 'N/A')"|"warning-base"|"warning-base-lighter"|"30")

# Docker container count
external("󰡨"|"$(docker ps -q 2>/dev/null | wc -l | tr -d ' ')"|"info-base"|"info-base-lighter"|"30")

# Node.js version
external("󰎙"|"$(node -v 2>/dev/null || echo 'N/A')"|"ok-base"|"ok-base-lighter"|"3600")

# Current Kubernetes namespace
external("󱃾"|"$(kubectl config view --minify -o jsonpath='{..namespace}' 2>/dev/null)"|"info-base"|"info-base-lighter"|"60")

External plugins are added to @powerkit_plugins alongside native plugins:

# Mix native and external plugins
set -g @powerkit_plugins "cpu,memory,external(\"󰊠\"|\"$(hostname -s)\"|\"info-base\"|\"info-base-lighter\"|\"3600\"),git"

# Multiple external plugins
set -g @powerkit_plugins "datetime,external(\"󰀄\"|\"$(whoami)\"|\"ok-base\"|\"ok-base-lighter\"|\"3600\"),external(\"󰔟\"|\"$(uptime -p)\"|\"info-base\"|\"info-base-lighter\"|\"60\"),hostname"

1. Use appropriate TTL: For static info like hostname, use high TTL (3600+). For dynamic data, use lower TTL (30-60).

2. Test commands first: Run your commands in terminal to ensure they work before adding to config.

3. Handle errors: Use || echo 'fallback' to provide fallback values when commands fail.

4. Keep it short: Status bar space is limited. Truncate long outputs in your commands.

5. Escape quotes: Use \" for quotes inside the external plugin definition.

Each native plugin supports individual configuration via @powerkit_plugin_<name>_<option>. Common options include:

See individual plugin documentation for specific options.

• Configuration - All configuration options
• Developing Plugins - Create custom plugins
• Plugin Contract - How plugins work internally
• macOS Binaries - Native binary downloads