Display Terraform/OpenTofu workspace with production warnings and pending changes indicator.

󱁢 production
󱁢 dev
󱁣 staging*
󱁢 default

# Add to your tmux configuration
set -g @powerkit_plugins "terraform"

# Optional: Add workspace selector keybinding
set -g @powerkit_plugin_terraform_keybinding_workspace ""

# Reload tmux configuration
tmux source-file ~/.tmux.conf

set -g @powerkit_plugins "terraform"

# Tool selection (auto detects terraform or tofu)
set -g @powerkit_plugin_terraform_tool "auto"

# Display options
set -g @powerkit_plugin_terraform_show_pending "true"

# Production warning
set -g @powerkit_plugin_terraform_warn_on_prod "true"
set -g @powerkit_plugin_terraform_prod_keywords "prod,production,prd"

# Icons
set -g @powerkit_plugin_terraform_icon "󱁢"
set -g @powerkit_plugin_terraform_icon_pending "󱁣"

# Keybindings
set -g @powerkit_plugin_terraform_keybinding_workspace ""
set -g @powerkit_plugin_terraform_popup_width "60%"
set -g @powerkit_plugin_terraform_popup_height "60%"

# Cache
set -g @powerkit_plugin_terraform_cache_ttl "5"

This plugin uses plugin_should_be_active() to check if the current pane is in a Terraform directory before returning cached data. This ensures the plugin disappears immediately when switching to a non-Terraform directory, rather than showing stale data from the previous context.

set -g @powerkit_plugins "terraform"

set -g @powerkit_plugins "terraform"
set -g @powerkit_plugin_terraform_tool "tofu"

set -g @powerkit_plugins "terraform"
set -g @powerkit_plugin_terraform_keybinding_workspace "C-w"

set -g @powerkit_plugins "terraform"
set -g @powerkit_plugin_terraform_prod_keywords "prod,production,live,prd"

set -g @powerkit_plugins "terraform"
set -g @powerkit_plugin_terraform_show_only_in_dir "true"

set -g @powerkit_plugins "terraform"
set -g @powerkit_plugin_terraform_show_pending "false"

The plugin detects Terraform workspaces using multiple methods:

1. Environment file (fastest, no command execution)

   • Reads .terraform/environment

2. Tool command (fallback)

   • terraform workspace show
   • tofu workspace show

3. Default (if nothing found)

   • Returns "default"

A directory is considered a Terraform directory if it contains:

• .terraform/ directory (initialized project)
• *.tf files (Terraform configuration files)

The plugin detects pending changes by checking for:

• tfplan file in current directory
• tfplan file in .terraform/ directory

These files are created by terraform plan -out=tfplan.

When warn_on_prod is enabled, the plugin:

1. Checks workspace name against prod_keywords (case-insensitive)
2. Sets health to error if match found
3. Displays workspace in error color (red by default)

This helps prevent accidental modifications to production infrastructure.

OpenTofu is a fork of Terraform. The plugin supports both:

The plugin automatically falls back to the other tool if the preferred one isn't available.

The workspace selector uses tmux display-menu (not popup) to show and switch between available workspaces.

1. Verify you're in a Terraform directory:

   ls .terraform/
   ls *.tf

2. Check tool availability:

   which terraform
   # or
   which tofu

3. Verify workspace:

   terraform workspace show
   # or
   tofu workspace show

4. Test plugin directly:

   POWERKIT_ROOT="/path/to/tmux-powerkit" ./bin/powerkit-plugin terraform

The plugin reads from .terraform/environment file. If this is out of sync:

# Remove environment file
rm .terraform/environment

# Reinitialize
terraform init

# Select workspace
terraform workspace select <name>

1. Check workspace name matches keywords:

   terraform workspace show

2. Verify keywords configuration:

   tmux show-options -g | grep terraform_prod_keywords

3. Keywords are case-insensitive partial matches:

   • prod matches: prod, production, prod-us-east
   • prd matches: prd, prd-staging

1. Verify keybinding is set:

   tmux show-options -g | grep terraform_keybinding

2. Check for keybinding conflicts:

   tmux list-keys | grep "C-w"

3. Test helper script manually:

   bash ~/.config/tmux/plugins/tmux-powerkit/src/helpers/terraform_workspace_selector.sh select

The plugin looks for tfplan files. If always showing:

1. Check for leftover plan files:

   find . -name "tfplan"

2. Remove old plan files:

   rm tfplan
   rm .terraform/tfplan

3. Or disable pending detection:

   set -g @powerkit_plugin_terraform_show_pending "false"

Always enable production warnings:

set -g @powerkit_plugin_terraform_warn_on_prod "true"
set -g @powerkit_plugin_terraform_prod_keywords "prod,production,live"

This provides visual confirmation when working in production environments.

Use workspace selector for quick switching:

set -g @powerkit_plugin_terraform_keybinding_workspace "C-w"

Then:

1. Navigate to Terraform directory
2. Press prefix + C-w
3. Select workspace from menu
4. Plugin updates automatically

For projects with many environments, customize keywords:

set -g @powerkit_plugin_terraform_prod_keywords "prod,production,live,prd"

This ensures all production-like environments trigger warnings.

The plugin uses src/helpers/terraform_workspace_selector.sh for workspace management:

# List workspaces
bash ~/.config/tmux/plugins/tmux-powerkit/src/helpers/terraform_workspace_selector.sh list

# Select workspace
bash ~/.config/tmux/plugins/tmux-powerkit/src/helpers/terraform_workspace_selector.sh select

• PluginKubernetes - Kubernetes context and namespace
• PluginCloud - Cloud provider profile
• PluginGit - Git repository status