Skip to content

Repository files navigation

DeployDiff CLI

GitHub stars

Preview infrastructure changes with human-readable diffs, cost impact estimation, and rollback commands — before you hit deploy.

Star this repo if you manage infrastructure — it helps other devs find DeployDiff!

GitHub releasePythonLicense: MITOpen Source Alternative |LibHunt |PyPI|

Installation

DeployDiff is not published on public PyPI (publishing is pending). Install directly from GitHub:

pip install git+https://github.com/Coding-Dev-Tools/deploydiff.git

Or install via Homebrew (macOS/Linux):

brew tap Coding-Dev-Tools/tap
brew install deploydiff

Or install via Scoop (Windows):

scoop bucket add Coding-Dev-Tools https://github.com/Coding-Dev-Tools/scoop-bucket
scoop install deploydiff

Usage

# Preview infrastructure changes
deploydiff preview --tf plan.json
deploydiff preview --cfn changeset.json
deploydiff preview --pulumi preview.json
deploydiff preview --tf plan.json -v # verbose: before/after details# Estimate cost impact
deploydiff cost --tf plan.json
deploydiff cost --cfn changeset.json
deploydiff cost --tf plan.json --pricing custom-pricing.json
# Generate rollback commands
deploydiff rollback --tf plan.json
deploydiff rollback --cfn changeset.json
# Run as MCP server (for AI agent integration)
deploydiff mcp

What You Get With preview

  • Resource summary: count of creates, updates, deletes, and replaces
  • Property-level diffs: what changed, from what to what
  • Destructive action highlighting: replaces and deletions called out
  • Multi-provider: Terraform, CloudFormation, Pulumi from a single CLI

What You Get With cost

  • Cost impact estimate: before vs. after per resource
  • Provider-native pricing: reads Terraform/CFN cost metadata
  • Summary row: total monthly change

What You Get With rollback

  • Generated rollback commands: reverse the last plan
  • Provider-specific: correct syntax for Terraform, CloudFormation
  • No manual command construction: eliminates panic-mode mistakes

MCP Server Mode

DeployDiff can run as an MCP (Model Context Protocol) server, letting AI coding agents like Claude Code and Cursor interact with your infrastructure diffs directly:

# Start MCP server (requires click-to-mcp)
deploydiff mcp

CI/CD Integration

# Preview changes in CI pipeline
deploydiff preview --tf plan.json
# Check cost impact before deploy
deploydiff cost --tf plan.json
# Generate rollback commands for rapid recovery
deploydiff rollback --tf plan.json

Combine with shell scripting for pipeline gating:

# Gate on destructive changes (check preview output for destroy actions)
deploydiff preview --tf plan.json | grep -q "destroy"&&echo"WARNING: Contains destructive changes!"# Check cost impact (use --pricing for custom pricing data)
deploydiff cost --tf plan.json --pricing custom-pricing.json

Pricing

DeployDiff is one of 11 tools in the Revenue Holdings suite. One license covers all CLI tools.

PlanPriceBest For
Free$0Individual devs, OSS — CLI only, 1 plan comparison
DeployDiff Individual$15/mo ($12 billed annually)Professional devs — unlimited plans, cost estimation
Suite (all 11 tools)$49/mo ($39 billed annually)Full Revenue Holdings toolkit — 40% savings
Team$79/mo ($63 billed annually)Up to 5 devs — shared reports, Slack alerts
EnterpriseCustomSSO, RBAC, compliance reports, dedicated support

🔹 No lock-in: CLI works fully offline on the free tier — no telemetry, no phone-home. 🔹 Annual billing: Save 20%.

Per-Tier Features

FeatureFreeDeployDiffSuiteTeamEnterprise
CLI: preview, cost, rollback
Unlimited stacks
Cost impact estimation
Multi-provider (TF, CFN, Pulumi)
Team collaboration / shared reports
Slack / webhook alerts
Compliance reports
RBAC
SSO / SAML / OIDC
Priority supportCommunity24h24h8hDedicated

Part of Revenue Holdings — CLI tools built by autonomous AI.

License

MIT

Install

npm install

Test

npm test# runs: node --test tests/