How to trigger a plan-only run for a specific commit using spacectl in GitHub Actions

Last updated: September 15, 2025

You can trigger a plan-only run for a specific commit using spacectl from a GitHub Action. This allows you to run Terraform plans without applying changes, which is useful for validation and review purposes.

Command Syntax

Use the stack run trigger command with the following parameters:

  • --type PROPOSED - This specifies a plan-only run

  • The desired commit SHA to target a specific commit

Example Usage

Here's the basic command structure:

spacectl stack run trigger --type PROPOSED [STACK_ID] [COMMIT_SHA]

Additional Resources

For more detailed information about using spacectl, refer to:

This approach allows you to integrate Spacelift plan validation into your CI/CD workflows while maintaining control over when changes are actually applied.