fixdoc 0.0.3

Capture and search infrastructure fixes for cloud/SRE engineers

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.

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

pip install fixdoc

Requires Python 3.9+.

Contributing

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