AlgoFest 2026 Submission | AI/ML Track

An autonomous, local AI debugging agent that intercepts crashes before you see them. Crash-Copilot wraps your standard execution commands, catches terminal errors instantly, and uses advanced LLM reasoning to generate an interactive HTML report with the root cause and the exact fixed code.

We built Crash-Copilot to solve the biggest bottleneck in development: parsing terminal spaghetti.

• Model Agnostic (BYOM): We built this architecture to be entirely model-flexible. While our official submission uses Z.AI's GLM-5.1 for its superior speed and context window, teams can easily swap in OpenAI, Anthropic, or even local open-source models to meet enterprise privacy requirements.
• Innovation: Instead of copying and pasting errors into ChatGPT, Crash-Copilot invisibly intercepts the stderr stream directly from your machine.
• Technical Complexity: Uses custom Regex to hunt down the exact broken file on your hard drive, extracts the context, and hands it to the reasoning engine.
• Practical Impact: Features a persistent local chat companion that holds your entire stack trace and local code in its context window for follow-up questions.

• 🔌 Bring Your Own Model — Configurable for GLM-5.1, GPT-4, Claude, or local LLMs.
• 🔍 Instant AI Diagnosis — Root cause, fixed code, and bullet-point explanation.
• 📋 One-Click Copy — Every code block has a clipboard button for immediate pasting.
• 💬 Persistent Chat Companion — Ask follow-up questions with full crash context.
• 🌐 Auto-HTML UI — Opens a stunning, styled HTML report directly in your browser.
• 🔒 Zero Heavy Dependencies — Uses Python requests, no complex framework installations.
• 🌍 Language Agnostic — Works with Python, Node.js, Go, Rust, Java, and more.

git clone https://github.com/gamingxt/crash-copilot.git

cp crash-copilot/.env.example crash-copilot/.env

Edit crash-copilot/.env with your preferred AI provider. By default, it is optimized for Z.AI (GLM-5.1):

# Default: Z.AI (GLM-5.1)
GLM_API_KEY=your_actual_api_key_here

# Optional: Swap to other providers if needed
# OPENAI_API_KEY=...
# ANTHROPIC_API_KEY=...

Make ccp a global command on your machine.

Windows:

crash-copilot\install.bat

(Open a new terminal after running)

macOS / Linux:

chmod +x crash-copilot/install.sh && crash-copilot/install.sh

Wrap any normal run command with ccp. To test the AI workflow with a deliberate crash:

ccp python crash-copilot/script.py

If the script crashes, Crash-Copilot catches it, talks to the configured AI model, and opens the fix in your browser.

The .env is automatically discovered from the current directory up to 6 parent levels—no matter where you run ccp from.

• Ashik - Core Logic, AI Integration, & CLI Architecture