# Configdrift

> Detect configuration drift across environments before it causes incidents

- **Type:** MCP server
- **Install:** `agentstack add mcp-coding-dev-tools-configdrift`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Coding-Dev-Tools](https://agentstack.voostack.com/s/coding-dev-tools)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Coding-Dev-Tools](https://github.com/Coding-Dev-Tools)
- **Source:** https://github.com/Coding-Dev-Tools/configdrift
- **Website:** https://coding-dev-tools.github.io/devforge/

## Install

```sh
agentstack add mcp-coding-dev-tools-configdrift
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ConfigDrift

[](https://github.com/Coding-Dev-Tools/configdrift/stargazers)

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!

[](https://github.com/Coding-Dev-Tools/configdrift/releases)

[](https://github.com/Coding-Dev-Tools/configdrift/blob/main/LICENSE)
[](https://www.opensourcealternative.to/project/configdrift)
|[](https://www.libhunt.com/r/Coding-Dev-Tools/configdrift)
|[](https://pypi.org/project/configdrift/)

Real-world scenarios:
- **Multi-environment compliance**: Ensure staging and prod configs are identical before every deploy
- **Secrets audit**: Detect env vars that exist in one environment but are missing in another
- **CI/CD gating**: Block PRs that introduce config drift across environments
- **Incident prevention**: Catch a changed database endpoint before it causes a production outage

## Installation

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

Editable install for development:
```bash
pip install -e ".[dev]"
```

Then run: `configdrift --help`

## Quick Start

Compare two config files:

```bash
configdrift check dev.yaml prod.yaml
```

Scan entire directories as environments:

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

Use a config file to define environments:

```bash
configdrift init
configdrift scan --config .configdrift.yaml
```

## Usage

### `check` — Compare config files

```bash
configdrift check   [--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

```bash
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

```bash
configdrift init .
```

Creates `.configdrift.yaml` in the specified directory.

### CI/CD Integration

Use `--output silent` for CI gating:

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

### GitHub Actions example

```yaml
- name: Detect config drift
  run: |
    pip install configdrift
    configdrift check ./config/staging/app.yaml ./config/prod/app.yaml --output silent
```

## Troubleshooting

- **Exit code 1 with no output**: use `--output table` to inspect drift details.
- **TOML parsing errors on Python 
  Part of Revenue Holdings — CLI tools built by autonomous AI.

## License

MIT

## Test

```bash
npm test  # runs: node --test tests/
```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Coding-Dev-Tools](https://github.com/Coding-Dev-Tools)
- **Source:** [Coding-Dev-Tools/configdrift](https://github.com/Coding-Dev-Tools/configdrift)
- **License:** MIT
- **Homepage:** https://coding-dev-tools.github.io/devforge/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-coding-dev-tools-configdrift
- Seller: https://agentstack.voostack.com/s/coding-dev-tools
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.