Untaint

Overview

Remove taint mark from resources to prevent forced recreation. Standalone verb plugin – mirrors terraform untaint as a top-level command. NavPush behavior: returns to the origin plugin on completion or cancel.

Screenshot

Untaint

Interactive (TUI)

Entry Points

Context Key Behavior
State list/detail T Navigate to untaint with cursor address
Plan list T Navigate to untaint with cursor address
Batch palette (!) T Navigate to untaint with all pinned addresses
Command mode :untaint Navigate to untaint

Keybindings

Key Action Context
y / Y / Enter Confirm untaint Confirming
n / N / Esc Cancel and return Confirming
p Navigate to plan Done
Esc Back to previous plugin Any
ctrl+r Retry Error

Flow

Idle → Confirming → Loading → Done/Error
  1. Plugin receives target address(es) via SetTargets()
  2. Shows confirmation: “Untaint <address>?”
  3. For batch: shows count and lists all addresses
  4. On confirmation, executes terraform untaint for each address sequentially
  5. On success, emits PlanInvalidatedEvent (plan auto-replans)
  6. NavPush returns user to origin plugin

Command Line (CLI)

tfui untaint <address>           # Untaint single resource
tfui untaint <addr1> <addr2>     # Batch untaint

Exit Codes

Code Meaning
0 Untaint succeeded
1 Untaint failed

Equivalence

Goal CLI TUI
Untaint a resource tfui untaint <address> From state/plan: Ty
Batch untaint tfui untaint <addr1> <addr2> Pin multiple → !Ty

Configuration

# tfui.hcl
plugin "untaint" {
  enabled = true
}
  • Taint – mark resources for recreation
  • State Browser – browse resources and untaint from context
  • Plan – see the effect of untainting

This site uses Just the Docs, a documentation theme for Jekyll.