ConfigDrift

Keep configurations consistent across all environments, automatically. ConfigDrift compares configs, flags drift, and reports compliance violations before they cause incidents.

⭐ Star this repo if you manage multi-environment configs — it helps other devs find ConfigDrift!

Installation

pip install configdrift

Or install directly from GitHub:

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

Or install via Homebrew (macOS/Linux):

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

Or install via Scoop (Windows):

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

npm (Node.js wrapper):

npm install -g configdrift

Then run: configdrift --help

Quick Start

Compare two config files:

configdrift check dev.yaml prod.yaml

Scan entire directories as environments:

configdrift scan ./config/dev ./config/staging ./config/prod

Use a config file to define environments:

configdrift init
configdrift scan --config .configdrift.yaml

Usage

check — Compare config files

configdrift check <file1> <file2> [--output table|json|silent] [--baseline dev] [--target prod]

Output formats:

• table (default): Rich colored table output
• json: Machine-readable JSON for CI integration
• silent: Exit code only (0 = no breaking drift, 1 = breaking drift found)

scan — Compare environment directories

configdrift scan ./dev ./staging ./prod --baseline dev

Scans all config files in each directory, merges them, and compares against a baseline environment.

init — Generate a config file

configdrift init .

Creates .configdrift.yaml in the specified directory.

CI/CD Integration

Use --output silent for CI gating:

configdrift check dev.yaml prod.yaml --output silent || echo "Drift detected!"

Supported Formats

Format	Extension	Notes
YAML	.yaml, .yml	Full nested structure support
JSON	.json	Nested flattening
TOML	.toml	Python 3.11+ native
.env	.env	KEY=VALUE format

Severity Levels

• Info: Non-critical value changes
• Warning: Added or removed optional keys
• Breaking: Changes to critical keys (database*, auth*, api_key*, secret*, password*, token*, endpoint*)

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with coverage
pytest --cov=configdrift

Pricing

ConfigDrift is one of eight tools in the Revenue Holdings suite. One license covers all CLI tools.

Plan	Price	Best For
Free	$0	Individual devs, OSS — CLI only, 1 env pair
ConfigDrift Individual	$15/mo ($12 billed annually)	Professional devs — unlimited environments, custom rules
Suite (all 8 tools)	$49/mo ($39 billed annually)	Full Revenue Holdings toolkit — 40% savings
Team	$79/mo ($63 billed annually)	Up to 5 devs — drift history, Slack alerts, priority support
Enterprise	Custom	SSO, 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

Feature	Free	ConfigDrift	Suite	Team	Enterprise
CLI: check, scan	✓	✓	✓	✓	✓
Unlimited environments	—	✓	✓	✓	✓
Custom rules / policies	—	✓	✓	✓	✓
Drift history / audit trail	—	—	—	✓	✓
Slack / webhook alerts	—	—	—	✓	✓
Compliance reports	—	—	—	—	✓
RBAC	—	—	—	—	✓
SSO / SAML / OIDC	—	—	—	—	✓
Priority support	Community	24h	24h	8h	Dedicated

---

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

License

MIT