Three Intelligence Engines  //  Infrastructure

Your infrastructure has a memory problem.
FixDoc gives it three brains.

FixDoc classifies every error by memory-worthiness, analyzes change impact with score explanations, and learns from apply outcomes — so your team builds on past fixes instead of repeating them.

Capture. Classify. Predict.

$ pipx install fixdoc && fixdoc demo tour
Local-first by default. Stores fixes in ~/.fixdoc. Git sync is optional. Private fixes never sync.
fixdoc — defer-first capture
// INSTALL

Get started in 60 seconds

Install FixDoc and start building your fix library.

quick start
// INTELLIGENCE ENGINES

Three intelligence engines

Each engine handles a different phase of your infrastructure lifecycle

Change Intelligence

Understands what a Terraform change will do before you apply it.

  • Change impact scoring with sigmoid formula (0–100)
  • BFS propagation through dependency DAG
  • IAM sensitivity scoring with wildcard trust detection
  • Smart fix matching with 8 change domains
  • Contextual checks from attribute + history
  • Score explanation bullets (action, IAM, impact, history)
  • AI-powered natural language explanations
  • Outcome learning with plan fingerprint linking
Failure Intelligence

Classifies, diagnoses, and routes errors when your commands fail.

  • Memory-worthiness classifier (memory-worthy vs self-explanatory)
  • AI error diagnosis explaining WHY it happened
  • Fix suggestions with effectiveness scores
  • Slack push notifications with Block Kit
  • Recurrence-based promotion (3+ similar → memory-worthy)
Memory Engine

Stores, classifies, and retrieves fixes with type-aware rendering.

  • 4 memory types: fix, check, playbook, insight
  • Type-aware preview rendering in suggestions
  • Effectiveness tracking (applied_count, success_count)
  • Source error ID linking across sessions
  • Bidirectional markdown round-trip for Git sync
// CHANGE IMPACT ANALYZER

See your change impact. Understand why.

Understand how one change propagates through your infrastructure

Score: 0  / 100 [HIGH]
Plan Change Policy / RBAC Workloads Resources aws_iam_role.app DELETE iam_policy_attachment depth: 1 role_policy depth: 1 lambda_function.api depth: 2 ecs_task.worker depth: 2 ec2_instance.web depth: 2 s3_bucket.data depth: 3 dynamodb.sessions depth: 3 sqs_queue.events depth: 3 cloudwatch.alarms depth: 3
+25 delete action +18 IAM policy changed +15 BFS depth 3 +14 2 prior fix matches
analyze change impact before applying
# Analyze your change impact before applying
$ terraform show -json plan.tfplan > plan.json
$ fixdoc analyze plan.json
Score: 72.4 / 100  [HIGH]
Why this scored 72:
  +25 delete action on IAM role
  +18 IAM policy field changed
  +15 BFS propagation depth 3
  +14 2 prior fix matches
Relevant Past Fixes: aws_iam_role [high: error code: AccessDenied]
Contextual Checks: [attr] Verify IAM trust policy principals
// USE CASES

For every stage of your journey

Individual Engineers

Build your personal fix library. Stop googling the same error twice. Your solutions, always at your fingertips.

Teams

Shared knowledge base via Git sync. When one engineer solves it, everyone has access. No more duplicate debugging.

Onboarding

New engineers inherit your team’s fix history on day one. Reduce ramp-up time, accelerate productivity.

CI/CD Pipelines

Run change impact analysis on every PR. Gate merges by severity. Track outcomes post-apply.

// POSITIONING

Not another tool

FixDoc does one thing well

FixDoc is NOT
  • An incident management SaaS with dashboards and alerts
  • A service catalog portal you have to log into
  • A generic documentation tool
  • An AI wrapper that requires an API key to function
FixDoc IS
  • Terminal-first capture that fits your existing workflow
  • A searchable fix history that lives on your machine
  • An intelligent system that classifies errors, analyzes change impact, and learns from outcomes
// PRIVACY & STORAGE

Your data, your machine

What’s stored?

Issue descriptions, resolutions, tags, and timestamps. Each fix is a simple JSON entry + a markdown file.

Where does it live?

Everything is stored locally in ~/.fixdoc/. No cloud service, no remote database.

Does it phone home?

No. FixDoc makes zero network requests by default. It’s a pure CLI tool with no telemetry or analytics.

What about AI features?

AI diagnosis and AI explain are fully optional. Your API key stays on your machine. No data is sent unless you explicitly use --diagnose or --ai-explain. FixDoc works perfectly without them.