Skip to content

davidfowl/windbg-cli

 
 

Repository files navigation

windbg-cli

WinDbg/CDB crash dump analysis CLI tools with SKILLS for coding agents.

Forked from svnscha/mcp-windbg — the original MCP server for WinDbg crash analysis.

Available Skills

Skill Description
windbg-cli Analyze Windows crash dumps and debug processes using WinDbg/CDB

What are Skills?

Skills are lightweight prompts that teach coding agents how to use CLI tools effectively. They provide:

  • Token-efficient workflows that don't bloat LLM context
  • Purpose-built commands for specific tasks
  • Best practices for common scenarios

Requirements

Installing the Skill

GitHub Copilot CLI (recommended)

/plugin marketplace add davidfowl/mcp-windbg
/plugin install windbg-cli@mcp-windbg

Claude Code

mkdir -p .claude/skills/windbg-cli
curl -o .claude/skills/windbg-cli/SKILL.md \
  https://raw.githubusercontent.com/davidfowl/mcp-windbg/main/skills/windbg-cli/SKILL.md

Quick Start

# List available crash dumps
uv run --from windbg-cli windbg list-dumps

# Analyze a dump with full details
uv run --from windbg-cli windbg analyze C:\path\to\crash.dmp --all

# Run a single WinDbg command
uv run --from windbg-cli windbg cmd --dump C:\path\to\crash.dmp -c "!analyze -v"

# Interactive WinDbg shell
uv run --from windbg-cli windbg shell --dump C:\path\to\crash.dmp

CLI Commands

Command Purpose
list-dumps Discover crash dump files in a directory
analyze One-shot crash dump analysis with optional --stack, --modules, --threads, --all
cmd Run a single WinDbg command against a --dump or --remote target
shell Interactive WinDbg REPL for a --dump or --remote target

Global Options

--cdb-path PATH        Custom path to cdb.exe
--symbols-path PATH    Custom symbols path
--timeout SECONDS      Command timeout (default: 30)
--verbose              Enable verbose CDB output

Skills-less Operation

You can also point your agent directly at the tool's help:

Analyze C:\dumps\app.dmp using windbg.
Check uv run --from windbg-cli windbg --help for available commands.

License

MIT

About

Model Context Protocol for WinDBG

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 91.9%
  • PowerShell 8.1%