PR cost estimation puts an AWS cost report on every infrastructure pull request: a commenter action posts your CDK diff, CloudFormation comparison, or Terraform plan, and the CloudBurn GitHub App replies with the estimated cost change.
Setup steps
From IaC Cost Estimator in your dashboard:
- Install the CloudBurn GitHub App. Choose Install CloudBurn on GitHub, pick an organization and the repositories it may access, and GitHub brings you back to CloudBurn to confirm. Choose Link installation to connect that installation to your workspace — linking is what licenses PR cost estimations for the organization. If you have not picked a plan yet, CloudBurn sends you to the billing page to choose one and start your 14-day free trial.
- Select repositories. Under Selected repositories, toggle on the repositories that should use your plan's slots and choose Save repository selection. Only selected repositories receive cost estimates.
- Add one workflow action. Pick the action for your IaC tool — aws-cdk-diff-pr-commenter for AWS CDK and CloudFormation or terraform-plan-pr-commenter for Terraform — so pull requests send their infrastructure changes to CloudBurn. For CDK, pass the base and head cloud assemblies as
before-templateandafter-template; a diff-only run prices nothing. See what the app reads from the comment. - Open a pull request. CloudBurn replies with a cost estimation comment for the changed resources.
How the reports work
The comment contract, report confidence classes (fixed, assumed, unknown), and the .cloudburn/usage-assumptions.json file for usage-based pricing are documented in the GitHub App docs — start with the usage assumptions schema if you want assumption-aware estimates for usage-billed services.
Repository slots
Your plan sets how many repositories you can select at once: 1 on Starter, 5 on Pro, unlimited on Enterprise — see Plans and billing. The Selected repositories card shows the count as N of limit selected. At the limit, clear a selected repository before choosing another.
You can switch slots at any time; the change takes effect as soon as you save. Only workspace owners and admins can change the selection — see Workspaces and members.
Unlinking
The Linked GitHub installation card shows the organization whose pull requests are licensed, when it was linked, and when it was last validated. Unlink stops PR cost estimations for that organization until it is linked again.
What's next
| Read this | To learn |
|---|---|
| GitHub App overview | How diff comments become cost reports |
| Usage assumptions schema | Pricing usage-billed services from your own numbers |
| Plans and billing | Repository slots per plan |