Terraform Plan GitHub Action

Post formatted Terraform plan output as comments on Pull Requests. Review infrastructure changes before applying.


Stop digging through pipeline logs to review Terraform changes. The Terraform Plan GitHub Action posts formatted plan output directly to your Pull Request, so you can review infrastructure changes where you're already doing code review.

Why Use This

❌ Without TF Plan Action

✅ With TF Plan Action

  • Automatic PR comments - Formatted Terraform plan appears directly in your Pull Request
  • Smart updates - Refreshes existing comments instead of creating duplicates
  • Binary plan support - Works with plan files for accurate change detection
  • Fast execution - Built with native JavaScript, no Docker container startup overhead
  • Clean PRs - Optionally skip posting when there are no changes

What Gets Posted

The action parses your Terraform plan and organizes it into readable sections:

  • Resources to add - New infrastructure being created
  • Resources to change - Modifications to existing resources
  • Resources to destroy - Infrastructure being removed
  • Plan summary - Quick overview of all changes

The output is formatted with collapsible sections, making it easy to focus on what matters.

Who Is This For

Development teams using Terraform who want to:

  • Review infrastructure changes without leaving GitHub
  • Catch potential issues before applying
  • Speed up PR reviews with clear infrastructure visibility
  • Keep a record of what changed in each PR
What You WantWhere to Go
Get startedInstall Guide
See examplesUsage Examples
Configure inputsConfiguration Reference

Ready to Start?

Head to the Install guide to add the action to your workflow. If you want to see how it works first, check out the AWS Terraform Starter Kit - it has this workflow already configured.

Resources