tfrev 1.0.0

AI-powered Terraform plan reviewer — verify your plan matches your intent before apply

tfrev — AI-Powered Terraform Plan Reviewer

Verify your Terraform plan matches your code intent before apply.

tfrev uses Claude AI to review your terraform plan output against your code changes, catching mismatches, security risks, and unexpected side effects before they hit production.

Quick Start

# Install
pip install tfrev

# Set your API key
export ANTHROPIC_API_KEY=sk-ant-...

# Review a plan
terraform plan -out=tfplan
terraform show -json tfplan > plan.json

tfrev review --plan plan.json

Or use auto-detection:

terraform plan -out=tfplan
tfrev review --auto

To diff against a specific ref (e.g. last deployed SHA):

tfrev review --plan plan.json --base-ref abc1234

What It Catches

• Intent mismatches — plan does something the code change didn't intend
• Unexpected replacements — a tag change triggering a full resource destroy+create
• Security regressions — widened security groups, broadened IAM policies
• Blast radius — too many resources changing at once
• Drift — plan changes with no corresponding code change
• Policy violations — custom team rules defined in .tfrev.yaml

CI/CD Integration

GitHub Actions

- name: AI Plan Review
  uses: bishalOps/tfrev@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    post_comment: "true"
    fail_on: high

GitLab CI

include:
  - remote: 'https://raw.githubusercontent.com/bishalOps/tfrev/main/ci/gitlab/.gitlab-ci-template.yml'

Jenkins

Copy ci/jenkins/Jenkinsfile into your repo and add ANTHROPIC_API_KEY as a credential.

Any CI/CD

pip install tfrev
export ANTHROPIC_API_KEY=$YOUR_SECRET
tfrev review --auto --output markdown --fail-on high

Configuration

Create a .tfrev.yaml in your project root:

model: claude-sonnet-4-6
fail_on: high
policies:
  - name: no-public-ingress
    description: "Flag security group rules allowing 0.0.0.0/0"
    severity: critical
sensitive_resources:
  - aws_iam_*
  - aws_security_group*

See .tfrev.yaml.example for all options.

Sample Output

────────────────────────────────────────────────────────────────────────
  ❌  Verdict: FAIL   Confidence: 95%
────────────────────────────────────────────────────────────────────────

  This plan contains three significant security regressions introduced by the code diff:
  SSH access widened from a private CIDR to 0.0.0.0/0, an RDS database marked
  publicly_accessible=true, and an S3 bucket ACL changed from private to public-read. All
  four resource creations are explained by code changes, but the security posture of the
  planned infrastructure is critically degraded and should not be applied without
  deliberate review and approval.

  Resources: 4 reviewed  |  +4 create  |  ~0 update  |  -0 delete  |  -/+0 replace

  ID     Severity     Category             Resource                             Title
  ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  F001   CRITICAL     security             null_resource.web_sg                 SSH ingress opened to the entire internet (0.0.0.0/0)
  F002   CRITICAL     security             null_resource.app_db                 RDS database instance set to publicly_accessible=true
  F003   HIGH         security             null_resource.app_assets_bucket      S3 bucket ACL changed from private to public-read
  F004   MEDIUM       best_practice        null_resource.app_db                 deletion_protection is false on the database resource
  F005   MEDIUM       best_practice        null_resource.app_db                 db_instance_class upsized from db.t3.small to db.t3.medium via variable default change
  F006   LOW          best_practice        general                              All four resources lack lifecycle prevent_destroy protections

  ────────────────────────────────────────────────────────────────────────
  [F001] ❗ CRITICAL — SSH ingress opened to the entire internet (0.0.0.0/0)

  The code diff explicitly changes ingress_ssh_cidr from 10.0.0.0/8 (a private RFC-1918
  range) to 0.0.0.0/0, exposing SSH (port 22) to all public IPs.

  Code: main.tf (lines 18-19)
  Plan: null_resource.web_sg (create)

  Recommendation:
  Revert ingress_ssh_cidr to a specific, restricted CIDR. Consider using AWS Systems
  Manager Session Manager to eliminate SSH exposure entirely.

  ────────────────────────────────────────────────────────────────────────
  [F002] ❗ CRITICAL — RDS database instance set to publicly_accessible=true

  ...

Output Formats

tfrev review --plan plan.json --output table     # Terminal (default)
tfrev review --plan plan.json --output markdown  # PR comments
tfrev review --plan plan.json --output json      # Machine consumption

Exit Codes

Code	Meaning
0	Review passed
1	Review failed (findings at or above --fail-on severity)
2	Error (API failure, invalid input)

Cost

Each review is a single Claude API call. Cost scales with the size of your plan and diff.

License

MIT