Auto-Fix System Uses Claude Code Headless to Detect and Fix Production Errors
How the Auto-Fix System Works
A developer has built an automated system that detects and fixes production errors using Claude Code CLI in headless mode. The system has been running for several weeks and is described as free and open source, requiring only a Claude subscription.
System Architecture
The workflow follows this sequence:
- Production logs are monitored
- A watcher fingerprints errors, groups duplicates, and classifies severity
- 30-second settle window
- Critical/High error detection triggers the system
- Git worktree created (isolated branch that never touches main)
- Claude Code launched headless, scoped to the specific error
- Telegram notification: "New Error — Approve Fix?" with Approve/Skip options
- PR created automatically if approved
Key Implementation Details
The developer identified git worktrees as a critical component — each error gets its own isolated copy of the repository. Claude can read, edit, run tests, and perform other operations within this isolated environment. If a fix is unsatisfactory, the worktree can be deleted without affecting the main branch.
Claude sessions receive focused prompts containing:
- Error message
- Stack trace
- Affected path
- Severity level
The headless session runs with scoped tools: Read, Write, Edit, Glob, Grep, and Bash. An example prompt provided: "Fix this production error in the LevProductAdvisor codebase. Error: MongoServerError: connection pool closed. Stack: at MongoClient.connect (mongo-client.ts:88). Path: POST /api/products/list. Severity: CRITICAL."
Results and Performance
According to the developer:
- Critical infrastructure errors (database connection, authentication): Claude fixes 70-80% correctly
- Logic bugs with clear stack traces: Solid performance
- Vague errors without good stack traces: Hit or miss, usually skipped
The system handles straightforward issues like missing null checks or bad query logic effectively, often nailing them on the first attempt.
Additional Features
The developer built an interactive Telegram dashboard for monitoring:
- Queue Status
- Recent Errors
- System Status
- Refresh capability
The /errors view pulls from MongoDB and displays status information like "fixing • 5m ago," "detected • 12m ago," or "fixed • 2h ago."
Technical Stack
The system uses TypeScript, Express, MongoDB, node-telegram-bot-api, and Claude Code CLI. The developer notes that using the headless CLI avoids API costs, requiring only a Claude subscription running locally. Each session is scoped and isolated in a worktree, minimizing risk.
The developer plans to publish the repository on GitHub, describing it as generic — users point the watcher at their log files and configure severity patterns.
📖 Read the full source: r/ClaudeAI
👀 See Also
100 Popular Apps Reverse-Engineered into Markdown Design Specs for Claude UI Cloning
An open-source repo provides structured markdown design specs for 100 popular iOS apps, optimized for Claude to clone UIs consistently. Key techniques: exact color values, state coverage, spacing scales, and navigation graphs.
Marmy: A Self-Hosted Framework for Managing AI Coding Agents Remotely
Marmy is an open-source, MIT-licensed framework built with Claude Code that lets developers manage AI coding agents and tmux sessions from a mobile app. It includes a Rust agent for development machines and a React Native app for remote control.
BrowserKing: Open-Source Chrome Extension for Browser Control via Claude and Other Models
BrowserKing is a free, open-source Chrome extension that lets Claude and 15+ other models see and control your browser from a side panel. It takes screenshots, sends them to the model, and then acts on decisions to click buttons, fill forms, scroll, and navigate tabs.
Unsloth Studio enables 2x training speed with 70% VRAM reduction for local AI fine-tuning
Unsloth Studio provides tools to train and fine-tune language models on local hardware with 2x faster training and 70% VRAM reduction. It supports exporting models to GGUF format for use with Ollama and enables full local AI coding workflows on 24GB hardware like RTX 4090.