semvec/pypi-packages huggingface dataset:
fixdoc 0.0.3
Capture and search infrastructure fixes for cloud/SRE engineers
License: MIT
Requires Python: >=3.9
Keywords: devops, terraform, infrastructure, documentation, cli

# FixDoc

A CLI tool for cloud engineers to capture and search infrastructure fixes. Stop losing tribal knowledge in Slack threads and personal notes.

When you hit a Terraform error or Kubernetes failure, pipe it directly into FixDoc. It auto-detects the error source, extracts structured metadata, and prompts you for the resolution. Next time you or a teammate hits the same issue, search your fix history instead of starting from scratch.

```bash
terraform apply 2>&1 | fixdoc capture
fixdoc search "S3"
```

## Features

- **Pipe errors directly** from `terraform apply` or `kubectl` — no copy-pasting
- **Auto-parse errors** from Terraform (AWS, Azure, GCP) and Kubernetes
- **Similar fix suggestions** — shows matching fixes from your history before creating duplicates
- **Search your fix history** by keyword, tag, or error message
- **Watch mode** — wrap any command and auto-capture errors on failure
- **Blast radius analysis** — estimate the impact of Terraform changes before applying
- **Analyze Terraform plans** against your fix history before `apply`
- **CI gating** — fail pipelines when blast radius severity exceeds a threshold
- **Sync with your team** via a shared Git repo
- **Markdown export** — every fix generates a shareable `.md` file

## Installation

```bash
pip install fixdoc
```

Requires Python 3.9+.

## Contributing

```bash
git clone https://github.com/fiyiogunkoya/fixdoc.git
cd fixdoc
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
```

Run tests with `pytest`. Format with `black src/ tests/` and lint with `ruff check src/ tests/`.

## License

MIT