Repository navigation
Releases
Releases · CaptShanks/terraprism
v0.13.0
terraprism v0.13.0
Changes since v0.12.0
- fix: fetch full git history in release job so changelog can find tags (8acf2ff)
- fix: auto-generate release notes from git log instead of static fallback (75862c6)
- docs: update README hotkey table to reflect e/c scope semantics (4355110)
- fix: remove unused expandAll/collapseAll after scope refactor (69e4b90)
- fix: bind TUI colors to shell theme and scope e/c hotkeys (1efd5c0)
Install
go install github.com/CaptShanks/terraprism/cmd/terraprism@v0.13.0Or download the appropriate binary below and place it in your PATH.
v0.12.0
Added
- Generic collapsible sub-blocks — expanded plan resources now fold large maps, lists, and heredocs without provider-specific rules.
- Sub-object navigation — when a resource is expanded,
j/kcan move into foldable child blocks andEnter/Space,h, andltoggle the selected block. - Scoped recursive fold controls —
eandcexpand or collapse all foldable content under the selected resource or sub-block. - Global fold controls — use
EandCto expand or collapse all visible resources and nested foldable blocks. - Combined heredoc diffs — paired remove/add heredocs render as one foldable diff section instead of separate old/new blocks.
- Adjustable diff context — use
+/=to show more unchanged lines around diff hunks, or-to tighten the view. - One-line viewport scrolling — use
Ctrl+EandCtrl+Yto scroll through large expanded blocks without moving the selected resource or fold.
Fixed
- Preserve YAML indentation inside heredoc attributes such as
kubectl_manifest.yaml_body_parsed, including nested Kubernetes lists. - Reduce noisy
helm_release.metadataoutput through generic folding instead of hardcoded provider-specific hiding.
Usage
# In the TUI:
# - Expand a resource with Enter/Space
# - Use j/k to move into foldable sub-blocks
# - Use h/l or Enter/Space to collapse/expand a selected sub-block
# - Use E/C to expand/collapse everything visible
# - Use +/- to change diff context around changed lines
# - Use Ctrl+E/Ctrl+Y to scroll one line inside large expanded content
terraprism planv0.11.0
Added
- Live search filter — resources filter as you type in the search bar (
/)- Fuzzy matching — query characters match in order (e.g.
lmbdamatcheslambda) - Multi-term search — space-separated terms, all must match (fzf-style)
- Arrow keys (up/down) scroll the filtered list while the search bar is active
- Esc clears search and returns to the full list; j/k are typed into the search box
- Fuzzy matching — query characters match in order (e.g.
- Fail-safe userdata encoding pipeline — improved handling of base64/gzip/hex userdata in plan diffs
terraprism upgrade— upgrade to the latest release with a single command- Version check —
terraprism versionshows an update hint when a newer version is available - TUI footer nudge — when a newer version exists, a timely check (7-day cache) displays an update prompt at the bottom of the screen
- Curl fallback — if self-update fails (e.g. read-only install location), the command prints the manual upgrade instruction
TERRAPRISM_SKIP_UPDATE_CHECK— set to 1, true, or yes to skip all update checksTERRAPRISM_UPDATE_CHECK_INTERVAL— days between TUI update checks (default: 7)
Usage
# In TUI: press / to search, type to filter live, arrow keys to scroll results
terraprism plan
# Check for updates (shown when running version)
terraprism version
# Upgrade to the latest release
terraprism upgrade
# If self-update fails (read-only install), re-run the install script
curl -sSfL https://raw.githubusercontent.com/CaptShanks/terraprism/main/install.sh | shUpgrade from v0.10.0
Run terraprism upgrade or re-run the install script to get the latest binary.
v0.10.0
Added
- Terraform/OpenTofu command passthrough — run any terraform/tofu command through terraprism
terraprism init,terraprism validate,terraprism fmt,terraprism outputterraprism state list,terraprism import,terraprism workspace,terraprism graphterraprism console,terraprism show,terraprism providers, and more
Removed
--tofu,--light,--darkflags — useTERRAPRISM_TOFUandTERRAPRISM_THEMEenv vars instead
Note: If you relied on these flags, set the corresponding env vars or update your scripts.
See TERRAPRISM_TOFU and TERRAPRISM_THEME in v0.9.0.
Changed
- Cleaner dispatch:
terraprism init -hshows terraform help, not terraprism help
Usage
# Initialize with OpenTofu
TERRAPRISM_TOFU=1 terraprism init
# Validate and format
terraprism validate
terraprism fmt -recursive
# List state
terraprism state list
# Plan and apply (unchanged)
terraprism plan
terraprism applyv0.9.0
Added
TERRAPRISM_TOFU— set to 1, true, or yes to use OpenTofu instead of TerraformTERRAPRISM_THEME— set to "light" or "dark" to force color scheme- CLI flags override env vars when both are specified
Usage
# Use OpenTofu instead of Terraform (no --tofu flag needed)
TERRAPRISM_TOFU=1 terraprism plan
# Force dark theme
TERRAPRISM_THEME=dark terraprism apply
# Add to your shell profile for persistence
export TERRAPRISM_TOFU=1
export TERRAPRISM_THEME=darkv0.8.0
Added
- Status filter — filter resources by action (create, destroy, update, etc.)
- Sort — sort resource list by default, action, address, or type
- Sort picker includes hints for each option
- Esc key clears filters from main view or filter picker
Usage
In the TUI (after terraprism plan or terraprism apply):
- Filter by status — open the filter picker and choose an action (e.g.
create,destroy) - Sort — open the sort picker and choose default, action, address, or type
- Clear filters — press Esc to reset filters or exit the picker
v0.7.0
Added
- Diff engine with LCS and git-style context diffs
- Word wrap for plan output
- Base64 userdata decoding — decodes
user_data_base64blocks in diffs for readability - Granular diff highlighting (additions, deletions, context)
- History picker with scrolling and alt screen
- VHS demo script and README updates with demo GIF
Usage
# View a past plan — diffs are highlighted, userdata decoded
terraprism history view
# Long lines wrap instead of truncating
terraprism planv0.6.0
Added
- Full working directory path in history list and picker
- Color-coded output: plan (blue), apply (green), destroy (red)
- Color-coded status: SUCCESS (green), FAILED (red), CANCELLED (yellow)
- Auto-cleanup: removes old files when count exceeds 100
- fzf-style search now includes path in history picker
Fixed
- Separator width alignment (86 chars)
- Header PATH column padding
- Path column padding for consistent line width
- Unknown option error handling in history list
- Underscore sanitization in project names
- Parser edge case handling for projects named 'plan/apply/destroy'
Usage
# History list shows path, action type, and status with colors
terraprism history list
# Search in picker includes path — find plans by directory
terraprism history view
# Press / and type part of the path or project namev0.5.0
Added
terraprism history list— list all history with index numbersterraprism history view— interactive picker with j/k navigationterraprism history view <#>— view by index (1 = most recent)- fzf-style multi-term search in picker (
/to search) - Project name included in history filenames
Fixed
- Fix separator width alignment (70 chars)
- Sanitize underscores in project names (filename delimiter)
- Handle edge cases in filename parser (projects named 'plan' etc.)
- Error on unknown options in history list
- Fix header column alignment with printf formatting
Usage
# List all saved plans (most recent first)
terraprism history list
# Interactive picker — j/k to move, Enter to open, / to search
terraprism history view
# Open a specific entry by index
terraprism history view 3v0.4.0
Added
terraprism versioncommand to show terraform/tofu version
Usage
terraprism version