Skip to content

Releases

v0.13.0

Choose a tag to compare

@github-actions github-actions released this 26 May 15:28

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.0

Or download the appropriate binary below and place it in your PATH.

v0.12.0

Choose a tag to compare

@github-actions github-actions released this 01 May 14:46
a915f34

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/k can move into foldable child blocks and Enter/Space, h, and l toggle the selected block.
  • Scoped recursive fold controls — e and c expand or collapse all foldable content under the selected resource or sub-block.
  • Global fold controls — use E and C to 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+E and Ctrl+Y to 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.metadata output 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 plan

v0.11.0

Choose a tag to compare

@github-actions github-actions released this 02 Apr 15:01

Added

  • Live search filter — resources filter as you type in the search bar (/)
    • Fuzzy matching — query characters match in order (e.g. lmbda matches lambda)
    • 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
  • 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 version shows 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 checks
  • TERRAPRISM_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 | sh

Upgrade from v0.10.0

Run terraprism upgrade or re-run the install script to get the latest binary.

v0.10.0

Choose a tag to compare

@github-actions github-actions released this 24 Feb 22:45

Added

  • Terraform/OpenTofu command passthrough — run any terraform/tofu command through terraprism
  • terraprism init, terraprism validate, terraprism fmt, terraprism output
  • terraprism state list, terraprism import, terraprism workspace, terraprism graph
  • terraprism console, terraprism show, terraprism providers, and more

Removed

  • --tofu, --light, --dark flags — use TERRAPRISM_TOFU and TERRAPRISM_THEME env 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 -h shows 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 apply

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 24 Feb 22:10

Added

  • TERRAPRISM_TOFU — set to 1, true, or yes to use OpenTofu instead of Terraform
  • TERRAPRISM_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=dark

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 24 Feb 21:02

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):

  1. Filter by status — open the filter picker and choose an action (e.g. create, destroy)
  2. Sort — open the sort picker and choose default, action, address, or type
  3. Clear filters — press Esc to reset filters or exit the picker

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 23 Feb 19:17

Added

  • Diff engine with LCS and git-style context diffs
  • Word wrap for plan output
  • Base64 userdata decoding — decodes user_data_base64 blocks 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 plan

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 14 Jan 18:12

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 name

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 14 Jan 17:03

Added

  • terraprism history list — list all history with index numbers
  • terraprism history view — interactive picker with j/k navigation
  • terraprism 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 3

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 14 Jan 14:36

Added

  • terraprism version command to show terraform/tofu version

Usage

terraprism version