<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
    <title>svnscha - copilot</title>
    <subtitle>automating annoying tasks, sharing tips, and embracing less frustration</subtitle>
    <link rel="self" type="application/atom+xml" href="https://svnscha.de/tags/copilot/atom.xml"/>
    <link rel="alternate" type="text/html" href="https://svnscha.de"/>
    <generator uri="https://astro.build/">Astro</generator>
    <updated>2026-09-05T00:00:00+00:00</updated>
    <id>https://svnscha.de/tags/copilot/atom.xml</id>
    <entry xml:lang="en">
        <title>🚀 New Release: mcp-windbg 1.2.2</title>
        <published>2026-09-05T00:00:00+00:00</published>
        <updated>2026-09-05T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/mcp-windbg-1-2-2-release/"/>
        <id>https://svnscha.de/posts/mcp-windbg-1-2-2-release/</id>
        <summary type="html">A fix for missing Unicode output on Chinese, Japanese, and Korean Windows systems.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/mcp-windbg-1-2-2-release/">&lt;p&gt;Version 1.2.2 of &lt;strong&gt;mcp-windbg&lt;/strong&gt; is out. This release fixes missing Unicode output on Windows systems that use a multibyte code page, including Chinese, Japanese, and Korean systems.&lt;/p&gt;
&lt;p&gt;The bug was reported by a community member in &lt;a href=&quot;https://github.com/svnscha/mcp-windbg/issues/102&quot;&gt;issue #102&lt;/a&gt;. Thanks for taking the time to provide a clear report and help track it down.&lt;/p&gt;
&lt;h2 id=&quot;the-problem&quot;&gt;The Problem&lt;/h2&gt;
&lt;p&gt;The &lt;code&gt;du&lt;/code&gt; command, which displays a Unicode string, sometimes returned an empty result through mcp-windbg. Running the same command directly in CDB worked as expected. Other commands such as &lt;code&gt;db&lt;/code&gt; and &lt;code&gt;dw&lt;/code&gt; also worked against the same address.&lt;/p&gt;
&lt;p&gt;The important detail was the reporter's Chinese Windows system locale.&lt;/p&gt;
&lt;h2 id=&quot;what-caused-it&quot;&gt;What Caused It&lt;/h2&gt;
&lt;p&gt;mcp-windbg communicates with &lt;code&gt;cdb.exe&lt;/code&gt; through a pipe. It sends a command and reads the debugger's response from that pipe.&lt;/p&gt;
&lt;p&gt;On multibyte system code pages, such as Chinese 936, Japanese 932, Korean 949, or the &quot;Use Unicode UTF-8&quot; setting, CDB can truncate text while writing it to a pipe. The end of a line may be missing, including the closing quote and newline.&lt;/p&gt;
&lt;p&gt;For &lt;code&gt;du&lt;/code&gt;, this could remove the entire string. If the output was cut in the middle of a character, later commands could also time out because the session could no longer parse the incomplete output correctly.&lt;/p&gt;
&lt;p&gt;This only affects redirected output, which is why the command still looks correct when run in a normal debugger window. There is no CDB option that fixes the pipe output; interactive mode, batch mode, and ANSI log files all show the same problem.&lt;/p&gt;
&lt;h2 id=&quot;the-fix&quot;&gt;The Fix&lt;/h2&gt;
&lt;p&gt;CDB can write complete UTF-16 log files using &lt;code&gt;.logopen /u&lt;/code&gt;, so mcp-windbg now uses one on affected systems. The pipe is still used to manage command timing, but the command output itself is read from the UTF-16 log.&lt;/p&gt;
&lt;p&gt;This is not a special case for &lt;code&gt;du&lt;/code&gt;. It also fixes Unicode text in module paths, &lt;code&gt;!analyze&lt;/code&gt; output, string dumps, and other debugger commands. Systems with a single-byte code page continue to use the existing pipe-based output.&lt;/p&gt;
&lt;p&gt;I tested the fix with real crash dumps, a live kernel target, and remote sessions using the 1252, 936, and 65001 code pages.&lt;/p&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;Upgrade with:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#569CD6&quot;&gt; -U&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; mcp-windbg&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;If you use the Claude Code plugin, update the plugin to pick up the new version.&lt;/p&gt;
&lt;p&gt;The project is available on &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;GitHub&lt;/a&gt;. If you notice any other commands behaving differently on a non-English Windows system, please &lt;a href=&quot;https://github.com/svnscha/mcp-windbg/issues&quot;&gt;open an issue&lt;/a&gt;.&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>🚀 New Release: mcp-windbg 1.1.0</title>
        <published>2026-08-26T00:00:00+00:00</published>
        <updated>2026-08-26T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/mcp-windbg-1-1-0-release/"/>
        <id>https://svnscha.de/posts/mcp-windbg-1-1-0-release/</id>
        <summary type="html">Support for the 2.x MCP SDK, a new wait_for_break tool, and fixes for 'g' freezing the machine it was supposed to release.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/mcp-windbg-1-1-0-release/">&lt;p&gt;Version 1.1.0 of &lt;strong&gt;mcp-windbg&lt;/strong&gt; is out. It's the first release since &lt;a href=&quot;/posts/mcp-windbg-1-0-0-release/&quot;&gt;1.0.0&lt;/a&gt;, which was broken on fresh installs for some time.&lt;/p&gt;
&lt;h2 id=&quot;what-happened-101&quot;&gt;What Happened: 1.0.1&lt;/h2&gt;
&lt;p&gt;The dependency was &lt;code&gt;mcp&amp;gt;=1.28.1&lt;/code&gt; with no upper bound. When the MCP Python SDK shipped 2.0.0 - renaming &lt;code&gt;McpError&lt;/code&gt; to &lt;code&gt;MCPError&lt;/code&gt; and dropping the &lt;code&gt;@server.list_tools()&lt;/code&gt; decorator - every fresh install broke at import:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;ImportError: cannot import name 'McpError' from 'mcp.shared.exceptions'&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Existing installs worked fine; only new ones broke. That's the worst kind of bug: invisible to anyone who could report it. 1.0.1 capped the requirement at &lt;code&gt;&amp;lt;2.0.0&lt;/code&gt;. Thanks to @aphroteus for the fix and @arjunarjun07 for finding the cause.&lt;/p&gt;
&lt;p&gt;If you're still on 1.0.0, run &lt;code&gt;pip install --upgrade mcp-windbg&lt;/code&gt;. Any &lt;code&gt;pip install &quot;mcp&amp;lt;2&quot;&lt;/code&gt; workaround can go.&lt;/p&gt;
&lt;h2 id=&quot;support-for-the-2x-sdk&quot;&gt;Support for the 2.x SDK&lt;/h2&gt;
&lt;p&gt;A cap is a stopgap, not a fix. 1.1.0 runs on &lt;code&gt;mcp&amp;gt;=2.0.0&lt;/code&gt;: handlers are passed straight to &lt;code&gt;Server(...)&lt;/code&gt; instead of registered via decorators, and they return the SDK's result types (&lt;code&gt;ListToolsResult&lt;/code&gt;, &lt;code&gt;CallToolResult&lt;/code&gt;).&lt;/p&gt;
&lt;p&gt;Nothing changes for clients - same tools, same schemas, stdio and streamable-http both work as before. Python support is unchanged (the 2.x SDK wants 3.10+, like this project already did).&lt;/p&gt;
&lt;p&gt;Two changes so the next SDK release is boring instead of another five silent weeks:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;All runtime dependencies are capped at the next major version.&lt;/strong&gt; Without a ceiling, moving to 2.x would have left the same trap for 3.0.0. Since mcp-windbg is an application, not a library, upper bounds can't conflict with anything downstream - a breaking SDK release just becomes a failing CI run.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A weekly canary tests what users actually get.&lt;/strong&gt; CI installed from &lt;code&gt;uv.lock&lt;/code&gt;, so it only tested pinned versions, while real installs resolve whatever the ranges allow. The canary ignores the lock, installs the newest allowed versions, and runs the test suite every Monday. It's scheduled rather than tied to pull requests on purpose: an upstream break should page me, not block someone's unrelated PR.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;wait_for_break&quot;&gt;&lt;code&gt;wait_for_break&lt;/code&gt;&lt;/h2&gt;
&lt;p&gt;The one new tool. Resume a target with &lt;code&gt;g&lt;/code&gt;, go do something else, then call &lt;code&gt;wait_for_break&lt;/code&gt; to block until it stops again - breakpoint, bugcheck, or CTRL+BREAK. It returns everything the debugger printed along the way.&lt;/p&gt;
&lt;p&gt;If the wait expires, the target keeps running. Waiting never halts your machine behind your back.&lt;/p&gt;
&lt;h2 id=&quot;fixing-g-freezing-the-target&quot;&gt;Fixing &lt;code&gt;g&lt;/code&gt; Freezing the Target&lt;/h2&gt;
&lt;p&gt;This was bad and hid for a while, so let me be honest about it.&lt;/p&gt;
&lt;p&gt;Go-class commands (&lt;code&gt;g&lt;/code&gt;, &lt;code&gt;gh&lt;/code&gt;, &lt;code&gt;gn&lt;/code&gt;, &lt;code&gt;gN&lt;/code&gt;, &lt;code&gt;gc&lt;/code&gt;, &lt;code&gt;gu&lt;/code&gt;) hand control back to the target, after which the debugger stops reading stdin. The server queued an &lt;code&gt;.echo&lt;/code&gt; marker behind the &lt;code&gt;g&lt;/code&gt;, which never got answered - so the command sat until timeout, and the timeout's CTRL+BREAK halted the target again. Ask the machine to run, get it frozen a minute later. The opposite of what you asked for.&lt;/p&gt;
&lt;p&gt;Go-class commands are now sent bare and return immediately. Step commands (&lt;code&gt;p&lt;/code&gt;, &lt;code&gt;t&lt;/code&gt;, &lt;code&gt;pa&lt;/code&gt;, &lt;code&gt;ta&lt;/code&gt;, ...) are unaffected.&lt;/p&gt;
&lt;p&gt;Fixing that exposed several related problems:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;A command right after &lt;code&gt;g&lt;/code&gt; breaks in cleanly.&lt;/strong&gt; No manual &lt;code&gt;send_ctrl_break&lt;/code&gt;, and the target's output isn't thrown away.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A break-in sent immediately after &lt;code&gt;g&lt;/code&gt; no longer gets lost.&lt;/strong&gt; Resuming used to return before the debugger read the &lt;code&gt;g&lt;/code&gt;, leaving a window where a CTRL+BREAK hit the prompt instead of the target. Against a live KDNET target, a break sent with no gap was lost &lt;em&gt;every single time&lt;/em&gt;. The resume is now confirmed consumed before reporting success.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Break-in checks before signaling.&lt;/strong&gt; A CTRL+BREAK aimed at an already-stopped target would queue and re-halt it later. The session now probes for a prompt first and only signals if there's no answer, making speculative &lt;code&gt;send_ctrl_break&lt;/code&gt; calls safe.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;bp nt!X; g&lt;/code&gt; reports whether the breakpoint was set.&lt;/strong&gt; A typo'd symbol now shows up as &lt;code&gt;Couldn't resolve error&lt;/code&gt; instead of an endless wait.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;One operation per session at a time.&lt;/strong&gt; &lt;code&gt;wait_for_break&lt;/code&gt; parks on a worker thread while the server keeps answering other requests; a second call on the same session is refused immediately. Closing a session also ends any wait parked on it.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Kernel sessions over named pipe or serial connect.&lt;/strong&gt; &lt;code&gt;kd&lt;/code&gt; announces those links with a different message than KDNET, and only the latter was matched - so sessions that were actually attached timed out.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;Still one line:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; mcp-windbg&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Release notes: &lt;a href=&quot;https://github.com/svnscha/mcp-windbg/releases/tag/v1.1.0&quot;&gt;v1.1.0&lt;/a&gt; - Docs: &lt;a href=&quot;https://svnscha.github.io/mcp-windbg/&quot;&gt;svnscha.github.io/mcp-windbg&lt;/a&gt; - Source: &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;github.com/svnscha/mcp-windbg&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&quot;summary&quot;&gt;Summary&lt;/h2&gt;
&lt;p&gt;No headline features here. Just a dependency cap, a canary, one new tool, and a long list of places where the debugger and the server disagreed about who was talking. That's what a &lt;code&gt;.1&lt;/code&gt; release should be - especially after a 1.0.0 nobody could install.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;If mcp-windbg has helped you, I'd love to hear about it. Open an issue, reach out, or star the &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;repository&lt;/a&gt;. Thank you.&lt;/em&gt;&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>🚀 New Release: mcp-windbg 1.0.0</title>
        <published>2026-07-16T00:00:00+00:00</published>
        <updated>2026-07-16T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/mcp-windbg-1-0-0-release/"/>
        <id>https://svnscha.de/posts/mcp-windbg-1-0-0-release/</id>
        <summary type="html">Kernel debugging, session IDs, and a redesigned tool surface. The first stable release.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/mcp-windbg-1-0-0-release/">&lt;p&gt;I've just released version 1.0.0 of &lt;strong&gt;mcp-windbg&lt;/strong&gt;. Yes, one-point-zero. The headline: &lt;strong&gt;your AI assistant can now debug the Windows kernel.&lt;/strong&gt; The fine print: every tool has a new name, so bring your prompts. Both below.&lt;/p&gt;
&lt;h2 id=&quot;kernel-debugging&quot;&gt;Kernel Debugging&lt;/h2&gt;
&lt;p&gt;Three new tools, &lt;code&gt;open_kd_session&lt;/code&gt;, &lt;code&gt;run_kd_command&lt;/code&gt;, and &lt;code&gt;close_kd_session&lt;/code&gt;, drive &lt;code&gt;kd.exe&lt;/code&gt; against a live kernel target over the connections you would actually use:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;KDNET&lt;/strong&gt; (&lt;code&gt;net:port=...,key=...&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Named pipes&lt;/strong&gt; (&lt;code&gt;com:pipe,port=\\.\pipe\...&lt;/code&gt;) - the classic VM setup&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Serial&lt;/strong&gt; - because sometimes it is 2003 in your lab and that is fine&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Point your assistant at a VM, ask what that driver is up to, and let it run &lt;code&gt;!process&lt;/code&gt;, &lt;code&gt;!irql&lt;/code&gt;, &lt;code&gt;lm&lt;/code&gt;, and friends while you have your coffee.&lt;/p&gt;
&lt;p&gt;A kernel target is not a dump file: break in at the wrong moment and you have halted an entire machine. The tools are built around that reality:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Sessions arrive already stopped.&lt;/strong&gt; &lt;code&gt;open_kd_session&lt;/code&gt; waits for the connect banner and breaks in for you.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Closing resumes the target.&lt;/strong&gt; &lt;code&gt;close_kd_session&lt;/code&gt; sends &lt;code&gt;g&lt;/code&gt; by default; pass &lt;code&gt;resume: false&lt;/code&gt; only if you want the machine frozen on purpose.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;--kd-path&lt;/code&gt;&lt;/strong&gt; points the server at a specific &lt;code&gt;kd.exe&lt;/code&gt;, the counterpart to &lt;code&gt;--cdb-path&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;There are also two new guided prompts to go with it: &lt;strong&gt;&lt;code&gt;kernel-triage&lt;/code&gt;&lt;/strong&gt; investigates a kernel target (including telling a real bugcheck apart from a plain break-in, and releasing the machine at the end), and &lt;strong&gt;&lt;code&gt;remote-triage&lt;/code&gt;&lt;/strong&gt; does the same for a live user-mode process.&lt;/p&gt;
&lt;h2 id=&quot;session-ids&quot;&gt;Session IDs&lt;/h2&gt;
&lt;p&gt;The other big change: sessions are now first-class. Every &lt;code&gt;open_*&lt;/code&gt; tool returns an opaque &lt;strong&gt;session ID&lt;/strong&gt; (&lt;code&gt;cdb-…&lt;/code&gt; or &lt;code&gt;kd-…&lt;/code&gt;), and &lt;code&gt;run_*&lt;/code&gt;, &lt;code&gt;close_*&lt;/code&gt;, and &lt;code&gt;send_ctrl_break&lt;/code&gt; address a session by that ID. No more implicit sessions, no more addressing by dump path: open first, then talk. Opening the same dump twice gives you two independent sessions.&lt;/p&gt;
&lt;p&gt;The kind is enforced, too: pass a &lt;code&gt;cdb&lt;/code&gt; ID to &lt;code&gt;run_kd_command&lt;/code&gt; and you get an error naming the right tool. That matters more than it sounds when the caller is a model that occasionally guesses.&lt;/p&gt;
&lt;h2 id=&quot;the-breaking-changes&quot;&gt;The Breaking Changes&lt;/h2&gt;
&lt;p&gt;The old names conflated the product (WinDbg) with the engines doing the work (&lt;code&gt;cdb.exe&lt;/code&gt; for user mode, &lt;code&gt;kd.exe&lt;/code&gt; for kernel). That distinction is now load-bearing, so everything got renamed:&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;0.x&lt;/th&gt;
&lt;th&gt;1.0.0&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;list_windbg_dumps&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;list_dumps&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;open_windbg_dump&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;open_cdb_dump&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;open_windbg_remote&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;open_cdb_remote&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;run_windbg_cmd&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;run_cdb_command&lt;/code&gt; / &lt;code&gt;run_kd_command&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;close_windbg_dump&lt;/code&gt;, &lt;code&gt;close_windbg_remote&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;close_cdb_session&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;Also: &lt;code&gt;send_ctrl_break&lt;/code&gt; takes a &lt;code&gt;session_id&lt;/code&gt;, and the &lt;code&gt;connection_type&lt;/code&gt; parameter is gone because the tool name now says which engine you mean. If you have prompts or agent instructions written against the 0.x names, they need updating - that is exactly why this is 1.0.0 and not 0.16.0. The &lt;a href=&quot;https://svnscha.github.io/mcp-windbg/&quot;&gt;docs&lt;/a&gt; are rewritten around the new flow, including a &quot;Debug a kernel target&quot; guide.&lt;/p&gt;
&lt;h2 id=&quot;smaller-but-you-will-notice&quot;&gt;Smaller, But You Will Notice&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Per-call timeouts&lt;/strong&gt;: &lt;code&gt;timeout_seconds&lt;/code&gt; on any &lt;code&gt;open_*&lt;/code&gt; / &lt;code&gt;run_*&lt;/code&gt; overrides that tool's default. Useful when that one &lt;code&gt;!analyze -v&lt;/code&gt; against a 30 GB dump needs its time.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A slow command no longer wedges the session.&lt;/strong&gt; On timeout the server breaks in with CTRL+BREAK and resynchronizes, so the session is usable for the next command instead of stranded.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Output goes to the right command.&lt;/strong&gt; Every command waits on its own unique completion marker, so late output from a slow command can never be mistaken for the next one's result.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No more orphaned debuggers.&lt;/strong&gt; &lt;code&gt;cdb.exe&lt;/code&gt; launched via the Microsoft Store aliases spawns a child that a plain terminate left behind, still holding the target. Shutdown now kills the whole process tree.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;Still a one-liner:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; mcp-windbg&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Full release notes are on the &lt;a href=&quot;https://github.com/svnscha/mcp-windbg/releases/tag/v1.0.0&quot;&gt;v1.0.0 release page&lt;/a&gt;, and the project lives at &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;github.com/svnscha/mcp-windbg&lt;/a&gt;. A star is always appreciated.&lt;/p&gt;
&lt;h2 id=&quot;one-point-zero&quot;&gt;One-Point-Zero&lt;/h2&gt;
&lt;p&gt;Fourteen months ago this was a &lt;a href=&quot;/posts/ai-meets-windbg/&quot;&gt;weekend experiment&lt;/a&gt;. Today it sits at 1.4k stars and debugs kernels. Calling it 1.0 is a promise more than a milestone: the names are stable now, and breaking changes from here on will be rare and loud.&lt;/p&gt;
&lt;p&gt;Here is to stable.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;If mcp-windbg has helped you, I would love to hear about it. Reach out, open an issue, or just star the &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;repository&lt;/a&gt;. Thank you all.&lt;/em&gt;&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>🚀 New Release: mcp-windbg 0.15.0</title>
        <published>2026-06-09T00:00:00+00:00</published>
        <updated>2026-06-09T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/mcp-windbg-0-15-0-release/"/>
        <id>https://svnscha.de/posts/mcp-windbg-0-15-0-release/</id>
        <summary type="html">Break into live sessions, redact sensitive output before it reaches the model, and a brand-new documentation site. A year and a month in, with 1.4k stars and a community that keeps showing up.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/mcp-windbg-0-15-0-release/">&lt;p&gt;I've just released version 0.15.0 of &lt;strong&gt;mcp-windbg&lt;/strong&gt;. It has been a while since the &lt;a href=&quot;/posts/mcp-windbg-0-12-2-release/&quot;&gt;0.12.2 post&lt;/a&gt;, and three releases have landed since then. Rather than a single feature, this is a round-up of everything that has shipped: a way to break into a running session, a hook to scrub sensitive data before it ever reaches the model, and a proper documentation site to tie it all together.&lt;/p&gt;
&lt;h2 id=&quot;whats-new&quot;&gt;What's New&lt;/h2&gt;
&lt;h3 id=&quot;break-into-a-live-session&quot;&gt;Break into a live session&lt;/h3&gt;
&lt;p&gt;If you have used a real debugger, you know the moment: the process is spinning, you want to know what it is doing &lt;em&gt;right now&lt;/em&gt;, and you reach for CTRL+BREAK. That now works through the MCP interface too.&lt;/p&gt;
&lt;p&gt;The new &lt;code&gt;send_ctrl_break&lt;/code&gt; tool, contributed by &lt;a href=&quot;https://github.com/GeoYS&quot;&gt;@GeoYS&lt;/a&gt;, interrupts an active CDB/WinDbg session, for both dump and remote debugging workflows. So when you are driving a live target and it wanders off into a tight loop or a long wait, the model can break in, inspect the state, and carry on, the same way you would at the keyboard. This closes a real gap: before, a live session that was busy was a session you could only wait on.&lt;/p&gt;
&lt;h3 id=&quot;redact-sensitive-data-before-it-leaves-the-machine&quot;&gt;Redact sensitive data before it leaves the machine&lt;/h3&gt;
&lt;p&gt;Crash dumps are full of things you might not want to hand to a model: file paths with usernames, machine names, environment variables, command lines, sometimes worse. The new &lt;code&gt;--filter-script&lt;/code&gt; option lets you point the server at a trusted Python helper that can rewrite string-valued tool arguments and tool text output on the way through.&lt;/p&gt;
&lt;p&gt;The important part is the boundary. Your script only sees the string values, not the full MCP protocol messages, so you can do focused PII redaction (mask a username, strip a token, normalize a path) without writing a protocol-aware proxy. If you run a centralized analysis service, this is the piece that lets you control what actually crosses the wire.&lt;/p&gt;
&lt;h3 id=&quot;a-real-documentation-site&quot;&gt;A real documentation site&lt;/h3&gt;
&lt;p&gt;The project has outgrown a README and a wiki. There is now a proper &lt;a href=&quot;https://svnscha.github.io/mcp-windbg/&quot;&gt;documentation site&lt;/a&gt; built with MkDocs Material and deployed to GitHub Pages. It covers getting started, the individual use cases, and a reference for the command-line options, the tools, and client configuration.&lt;/p&gt;
&lt;p&gt;A few highlights worth calling out:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Use-case guides&lt;/strong&gt; for the things people kept asking about: running the server over HTTP to &lt;a href=&quot;https://svnscha.github.io/mcp-windbg/scenarios/http-service/&quot;&gt;debug from another machine&lt;/a&gt;, and scrubbing tool output to &lt;a href=&quot;https://svnscha.github.io/mcp-windbg/scenarios/redaction/&quot;&gt;redact sensitive data&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The built-in &lt;code&gt;dump-triage&lt;/code&gt; prompt&lt;/strong&gt; is now &lt;a href=&quot;https://svnscha.github.io/mcp-windbg/reference/prompts/&quot;&gt;documented&lt;/a&gt;, including its &lt;code&gt;dump_path&lt;/code&gt; argument, so you can trigger a full structured triage without hand-writing the workflow.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Honest limitations&lt;/strong&gt; are written down rather than discovered the hard way: the HTTP transport has no authentication, attach-by-PID is not supported, and sessions run concurrently.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;quieter-sturdier-foundations&quot;&gt;Quieter, sturdier foundations&lt;/h3&gt;
&lt;p&gt;This release also includes several smaller changes that matter in daily use:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;strong&gt;stdio transport no longer crashes on a malformed input line&lt;/strong&gt;. A single unparseable line used to tear down the whole process; now it is logged and the server keeps running.&lt;/li&gt;
&lt;li&gt;The &lt;strong&gt;test suite was rebuilt&lt;/strong&gt; as a declarative end-to-end harness. Every scenario runs against a really-hosted &lt;code&gt;python -m mcp_windbg&lt;/code&gt; server driven by a real MCP client, with only the LLM faked. Coverage now sits above 90 percent, measured in the subprocess where tool dispatch actually runs.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Package metadata is complete&lt;/strong&gt;, so &lt;code&gt;pip show&lt;/code&gt; and the PyPI page now carry the author, project URLs, and proper classifiers.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Symbols resolve more often out of the box&lt;/strong&gt;: the dump's own directory is now auto-included in the symbol search path, so PDBs sitting next to a dump are found without extra configuration.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;community-contributions&quot;&gt;Community Contributions&lt;/h2&gt;
&lt;p&gt;This stretch of releases leaned on the community, and two contributions stand out:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/GeoYS&quot;&gt;@GeoYS&lt;/a&gt; added the live break-in feature in &lt;a href=&quot;https://github.com/svnscha/mcp-windbg/pull/40&quot;&gt;#40&lt;/a&gt;, which became the &lt;code&gt;send_ctrl_break&lt;/code&gt; tool above. It is the headline of the 0.13.0 release.&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/SSyl&quot;&gt;@SSyl&lt;/a&gt; made symbols just work in more cases by auto-including the dump directory in the symbol search path (&lt;a href=&quot;https://github.com/svnscha/mcp-windbg/pull/41&quot;&gt;#41&lt;/a&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;This is exactly the kind of contribution that makes a tool better for everyone, not just the person who filed it. Thank you both.&lt;/p&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;Installation is unchanged and still a one-liner:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; mcp-windbg&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;The project is open source and available on GitHub at &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;https://github.com/svnscha/mcp-windbg&lt;/a&gt;. If you find it useful, a star on the repository is always appreciated.&lt;/p&gt;
&lt;h2 id=&quot;a-year-and-a-month-in&quot;&gt;A Year and a Month In&lt;/h2&gt;
&lt;p&gt;It is hard to believe, but mcp-windbg is now a year and a month old. When I &lt;a href=&quot;/posts/ai-meets-windbg/&quot;&gt;first wrote about it&lt;/a&gt; in May 2025, it was a weekend experiment to scratch my own itch: I was tired of typing the same WinDbg commands over and over, and I wanted to see whether a model could drive the debugger for me. I genuinely did not expect it to go anywhere.&lt;/p&gt;
&lt;p&gt;It went somewhere. The repository now sits at &lt;strong&gt;1.4k stars&lt;/strong&gt;, the original article reached tens of thousands of readers in its first days, and the project has shown up in conversations, talks, and threads far beyond anything I planned. People have used it to triage real production crashes, wired it into team workflows, and sent screenshots of it cracking bugs that had been open for weeks. Every one of those still makes my day.&lt;/p&gt;
&lt;p&gt;What has meant the most, though, is not the numbers. It is the people. Contributors who saw a gap and just fixed it. Folks who filed thoughtful issues, asked sharp questions, or pushed back when something did not work the way they needed. The many of you who reached out directly, by email, on LinkedIn, in DMs, to say the tool saved you an afternoon, or to suggest where it should go next. A project like this is only as good as the community around it, and this one has been generous well beyond what I could have hoped for.&lt;/p&gt;
&lt;p&gt;So this is mostly a thank-you note. Thank you for the stars, the pull requests, the issues, the messages, and for trusting a small open-source tool with your hardest crashes. You are the reason it keeps getting better, and the reason I keep shipping.&lt;/p&gt;
&lt;p&gt;Here is to the next year.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;If mcp-windbg has helped you, I would love to hear about it. Reach out, open an issue, or just star the &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;repository&lt;/a&gt;. Thank you all.&lt;/em&gt;&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>🚀 New Release: mcp-windbg 0.12.2</title>
        <published>2025-12-15T00:00:00+00:00</published>
        <updated>2025-12-15T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/mcp-windbg-0-12-2-release/"/>
        <id>https://svnscha.de/posts/mcp-windbg-0-12-2-release/</id>
        <summary type="html">Adding Prompts API support and streamable-http transport to mcp-windbg.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/mcp-windbg-0-12-2-release/">&lt;p&gt;I've just released version 0.12.2 of &lt;strong&gt;mcp-windbg&lt;/strong&gt;, bringing some significant enhancements that expand how and where you can perform crash dump analysis.&lt;/p&gt;
&lt;h2 id=&quot;whats-new&quot;&gt;What's New&lt;/h2&gt;
&lt;p&gt;This release introduces two major features that address the flexibility and deployment needs many of you have been asking about.&lt;/p&gt;
&lt;p&gt;First up is support for the &lt;strong&gt;Prompts API&lt;/strong&gt;, which fundamentally changes how you can interact with crash dump analysis. Rather than being tied to a local setup, you can now trigger triage analysis from anywhere in your environment. The server can be deployed on any machine in your network, whether that's a dedicated analysis box, a build server, or even directly on a file server hosting your crash dumps. This means you can centralize your debugging infrastructure and access it from wherever you're working.&lt;/p&gt;
&lt;p&gt;Second, this release adds &lt;strong&gt;streamable-http&lt;/strong&gt; as an alternative transport backend. This gives you more options for how the server communicates, particularly useful in containerized or networked environments where different transport mechanisms might be preferable.&lt;/p&gt;
&lt;p&gt;The combination of these features means you can now set up a centralized crash analysis service that developers across your team can leverage without needing to install WinDbg or configure everything locally. Want to analyze dumps directly on the file server where they're stored? Now you can.&lt;/p&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you want to try out the latest version, installation is straightforward:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; mcp-windbg&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;The project is open source and available on GitHub at &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;https://github.com/svnscha/mcp-windbg&lt;/a&gt;. If you find it useful, a star on the repository is always appreciated.&lt;/p&gt;
&lt;h2 id=&quot;a-real-world-example&quot;&gt;A Real-World Example&lt;/h2&gt;
&lt;p&gt;No release post would be complete without putting the tool to work on an actual crash dump. Here's an example of the analysis in action:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;/screenshots/2025-12-15-mcp-windbg-copilot-crash.jpg&quot; alt=&quot;Crash Analysis&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Even Copilot needs a debugger sometimes.&lt;/em&gt;&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>The Passenger Seat Developer</title>
        <published>2025-10-27T00:00:00+00:00</published>
        <updated>2025-10-27T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/the-passenger-seat-developer/"/>
        <id>https://svnscha.de/posts/the-passenger-seat-developer/</id>
        <summary type="html">Here's what nobody tells you about AI-assisted rapid prototyping: Every prototype feels like success, but success is measured by shipping, not building.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/the-passenger-seat-developer/">&lt;h2 id=&quot;the-great-prototype-experiment&quot;&gt;The Great Prototype Experiment&lt;/h2&gt;
&lt;p&gt;Here's what nobody tells you about AI-assisted rapid prototyping: After six months and nearly 100 projects, I had to face an uncomfortable truth.&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Every prototype feels like success. But is it really?&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;why-you-ask&quot;&gt;Why, You Ask?&lt;/h2&gt;
&lt;p&gt;Picture this: Me, armed with Claude, spinning up project after project like I'm some kind of coding machine gun. A productivity suite here, a file manager there, throw in some web scrapers, automation tools, data processors - you name it, I've probably built a prototype of it in the past six months.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Nearly 100 projects.&lt;/strong&gt; The dopamine hits were insane. Every idea that popped into my head, no matter how half-baked, could become a working prototype in hours instead of weeks. The velocity felt otherworldly.&lt;/p&gt;
&lt;p&gt;The result took me too long to acknowledge: &lt;strong&gt;out of nearly 100 prototypes, only one reached production.&lt;/strong&gt;&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;One. Literally. One.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;That project? &lt;a href=&quot;/posts/ai-meets-windbg/&quot;&gt;mcp-windbg&lt;/a&gt;. And guess what made it special? It's the only one where I spent those classic, grinding hours sitting there, actually understanding every line of code, debugging the edge cases, and wrestling with the gnarly implementation details.&lt;/p&gt;
&lt;h2 id=&quot;the-dopamine-factory&quot;&gt;The Dopamine Factory&lt;/h2&gt;
&lt;p&gt;Let me be real with you about what those early days felt like. I'd wake up with some random idea - &quot;What if I built a tool that automatically organizes screenshots by content?&quot; or &quot;I need a better way to manage my development environments&quot; - and by lunch, I'd have a working prototype.&lt;/p&gt;
&lt;p&gt;Six months ago, I was writing about &lt;a href=&quot;/posts/vscode-vibe-coding/&quot;&gt;vibe coding&lt;/a&gt; like I'd discovered fire. The euphoria was real - watching AI refactor entire codebases, generate complex implementations, solve architectural problems in seconds. I was living in that perfect state where &quot;the barrier between thinking and implementing just got so much thinner.&quot;&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Me: Build me a screenshot organizer that uses OCR to categorize images&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Claude: *Generates Python app with OCR integration, file management, GUI*&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;Me: This actually works perfectly!&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;The rush was incredible. Idea to implementation in hours. No tedious boilerplate. No debugging mysterious dependency issues. No wrestling with documentation. Just pure, frictionless creation.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;I felt like a goddamn wizard.&lt;/strong&gt; Every prototype that worked felt like validation that I'd cracked some secret code of productivity. Friends would ask what I was working on, and I'd rattle off a dozen projects like I was running a software factory.&lt;/p&gt;
&lt;p&gt;That euphoric beginning? It was exactly six months ago. Time has a funny way of providing perspective.&lt;/p&gt;
&lt;h2 id=&quot;the-reality-check-why-nothing-shipped&quot;&gt;The Reality Check: Why Nothing Shipped&lt;/h2&gt;
&lt;p&gt;After several months, my project folder had grown to nearly 100 directories, but I still had not shipped anything.&lt;/p&gt;
&lt;p&gt;Why? Because &lt;strong&gt;prototypes aren't products.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Every time I'd come back to one of these AI-generated prototypes to actually finish it - to handle edge cases, add proper error handling, write tests, or make it production-ready - I'd hit the same wall: &lt;strong&gt;I had no clue how the thing actually worked.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;The code looked familiar. The structure made sense at first glance. But when it came time to:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Debug why it crashed with certain file types&lt;/li&gt;
&lt;li&gt;Add a feature that required understanding the data flow&lt;/li&gt;
&lt;li&gt;Optimize performance bottlenecks&lt;/li&gt;
&lt;li&gt;Handle edge cases the AI hadn't considered&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;I was lost. Completely, utterly lost.&lt;/p&gt;
&lt;h2 id=&quot;the-one-that-made-it-mcp-windbg&quot;&gt;The One That Made It: mcp-windbg&lt;/h2&gt;
&lt;p&gt;So why did mcp-windbg succeed when 99 others failed? It wasn't because I spent months on it - it was a small weekend project. But I approached it differently.&lt;/p&gt;
&lt;p&gt;I started by vibe-coding with Claude, just like the other prototypes. Got the basic structure working, had it generating and parsing WinDBG commands. But then - and this is the crucial difference - I actually went back and reviewed what the AI had built. Debugged the edge cases myself. Traced through the subprocess communication to understand how it really worked.&lt;/p&gt;
&lt;p&gt;When pytest failures popped up, I didn't just ask Claude to fix them. I sat there and figured out why they were failing. When the CDB interaction got weird with certain commands, I debugged it manually until I understood the communication protocol.&lt;/p&gt;
&lt;p&gt;The result? A weekend project that actually solved a real problem in my daily work. Something I could confidently maintain, extend, and explain to others.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;I owned the code because I'd taken the time to understand what Claude had built.&lt;/strong&gt;&lt;/p&gt;
&lt;h2 id=&quot;the-brutal-truth-about-ai-generated-prototypes&quot;&gt;The Brutal Truth About AI-Generated Prototypes&lt;/h2&gt;
&lt;p&gt;Those 99 failed projects weren't failures because the code was bad. Most of them actually worked pretty well for their basic use cases. They failed because I'd delegated understanding to AI instead of using it as a tool to support my understanding.&lt;/p&gt;
&lt;p&gt;Here is what was happening:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Week 1&lt;/strong&gt;: &quot;Holy shit, look at this amazing prototype!&quot;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Week 2&lt;/strong&gt;: &quot;I should probably clean this up and ship it&quot;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Week 3&lt;/strong&gt;: &quot;Hmm, there are some edge cases I need to handle&quot;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Week 4&lt;/strong&gt;: &quot;Why is this crashing? Let me ask Claude to fix it&quot;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Week 5&lt;/strong&gt;: &quot;The fix broke something else. This is getting messy&quot;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Week 6&lt;/strong&gt;: &quot;Maybe I'll just start a new project instead...&quot;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Sound familiar? This cycle repeated so consistently I could set my calendar by it.&lt;/p&gt;
&lt;h2 id=&quot;the-sitting-there-hours-why-they-matter&quot;&gt;The Sitting-There Hours: Why They Matter&lt;/h2&gt;
&lt;p&gt;You know those classic hours every developer has experienced? The ones where you're just sitting there, staring at code, trying to figure out why something isn't working the way you expect? Those moments when you're debugging line by line, tracing execution paths, and slowly building up a mental model of how everything fits together?&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Those hours aren't wasted time. They're investment time.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;When you skip those hours - when you let AI generate the solution and just accept it - you never build that intimate knowledge of your own system. You become a tourist in your own codebase.&lt;/p&gt;
&lt;p&gt;With mcp-windbg, I didn't spend weeks wrestling with it - it was just a weekend project. But during that weekend, when I hit issues with subprocess communication or weird CDB behavior, I actually debugged them myself instead of immediately asking Claude for fixes. I took the time to understand why certain commands failed and how the debugging session management worked.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;That weekend of actually understanding what I was building made the difference between prototype #99 and shipped product #1.&lt;/strong&gt;&lt;/p&gt;
&lt;h2 id=&quot;the-false-productivity-trap&quot;&gt;The False Productivity Trap&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;I felt productive while building those 99 prototypes.&lt;/strong&gt; Each working demo felt like progress, and my GitHub activity supported that impression. It did not mean I was finishing useful products.&lt;/p&gt;
&lt;p&gt;But productivity isn't about how much code you generate. It's about how much value you ship. And by that metric, I had a 1% success rate.&lt;/p&gt;
&lt;p&gt;The problem was not AI itself, but how I used it. I treated it as a replacement for understanding instead of a debugger or knowledge base that could help me learn faster.&lt;/p&gt;
&lt;h2 id=&quot;how-i-use-ai-now&quot;&gt;How I Use AI Now&lt;/h2&gt;
&lt;p&gt;I still use AI regularly, but now I treat it like any other development tool.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;AI as a knowledge base&lt;/strong&gt;: &quot;How does subprocess communication work in Python?&quot; &quot;What are the edge cases for file parsing?&quot; &quot;Show me different approaches to error handling.&quot;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;AI as a debugging partner&lt;/strong&gt;: &quot;Here's my stack trace, what could be causing this?&quot; &quot;This function isn't behaving as expected, help me trace through the logic.&quot;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;AI for the boring repetitive stuff&lt;/strong&gt;: Boilerplate code, test scaffolding, documentation generation, refactoring patterns I've done a million times.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;AI as a code reviewer&lt;/strong&gt;: &quot;Does this implementation handle edge cases properly?&quot; &quot;Are there performance issues with this approach?&quot;&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The key difference: &lt;strong&gt;I use AI to accelerate my understanding, not replace it.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;For anything I might ship, the rule is simple: &lt;strong&gt;If I can't explain how the core functionality works without looking at the code, I don't ship it.&lt;/strong&gt; AI can help me get there faster, but it can't get there for me.&lt;/p&gt;
&lt;p&gt;This isn't about being a purist or rejecting AI assistance - it's about maintaining professional competence and shipping software you can actually support.&lt;/p&gt;
&lt;h2 id=&quot;what-success-actually-looks-like&quot;&gt;What Success Actually Looks Like&lt;/h2&gt;
&lt;p&gt;After six months of this experiment, here's what I've learned about successful AI-assisted development:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Delegate the repetitive stuff&lt;/strong&gt;: Boilerplate generation, test scaffolding, documentation, refactoring patterns you've done before.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Use it as a knowledge multiplier&lt;/strong&gt;: Research APIs, explore different approaches, get explanations of complex concepts, debug tricky issues.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Keep the understanding&lt;/strong&gt;: Architecture decisions, core business logic, data flow design, system integration points.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Invest in the sitting-there hours&lt;/strong&gt;: For anything you plan to ship, spend the time to truly understand how it works.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;AI is similar to a good debugger or profiler: it can make you more effective, but it does not replace understanding the system you are building.&lt;/p&gt;
&lt;h2 id=&quot;the-uncomfortable-question&quot;&gt;The Uncomfortable Question&lt;/h2&gt;
&lt;p&gt;Here's the question that keeps me up at night: &lt;strong&gt;How many developers are building careers on AI-generated code they don't understand?&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;This is also a matter of professional responsibility. If you own a piece of code, you should be able to explain, modify, and debug it, especially when a production issue occurs and the AI assistant is unavailable.&lt;/p&gt;
&lt;p&gt;I don't have a good answer to that question. I just know I don't want to be that kind of developer.&lt;/p&gt;
&lt;h2 id=&quot;summary&quot;&gt;Summary&lt;/h2&gt;
&lt;p&gt;After six months and nearly 100 AI-assisted prototypes, only mcp-windbg shipped. The difference was that I used AI to speed up my learning instead of asking it to replace that learning.&lt;/p&gt;
&lt;p&gt;Remember that uncomfortable truth from the beginning? Every prototype feels like success, but success is measured by shipping, not building. The dopamine hits from rapid prototyping are real, but they're not the same as the satisfaction of maintaining code you actually understand.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;The lesson isn't to use less AI. The lesson is to use it better.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;AI is like having a brilliant research assistant, debugger, and code reviewer all rolled into one. Use it to explore ideas faster, understand concepts deeper, and eliminate the boring repetitive work that burns you out. But don't delegate the understanding itself.&lt;/p&gt;
&lt;h2 id=&quot;next-steps&quot;&gt;Next Steps&lt;/h2&gt;
&lt;p&gt;If this resonates with you, here's what I'd suggest doing right now:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Audit your current projects:&lt;/strong&gt; Look at your recent work. Can you explain how the core functionality works without looking at the code? If not, spend some time diving into those systems.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Set a new rule:&lt;/strong&gt; For anything you plan to ship, implement the &quot;explain it without looking&quot; test. If you can't walk someone through how it works from memory, you're not ready to ship.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Change how you prompt:&lt;/strong&gt; Instead of &quot;Build me X,&quot; try &quot;Help me understand how to build X&quot; or &quot;What are the key concepts I need to know for X?&quot;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Embrace the sitting-there hours:&lt;/strong&gt; When you hit a bug or weird behavior, resist the urge to immediately ask AI for a fix. Spend 15-20 minutes trying to understand it yourself first.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Someone still needs to own the code. AI can help you move faster, but it cannot take that responsibility from you.&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>🚀 New Release: mcp-windbg 0.10.0</title>
        <published>2025-10-11T00:00:00+00:00</published>
        <updated>2025-10-11T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/mcp-windbg-0-10-0-release/"/>
        <id>https://svnscha.de/posts/mcp-windbg-0-10-0-release/</id>
        <summary type="html">AI-powered crash analysis gets a major upgrade with PyPI availability, live debugging sessions, and community-driven improvements. One-command installation is finally here.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/mcp-windbg-0-10-0-release/">&lt;h2 id=&quot;mcp-windbg-0100-now-available-on-pypi&quot;&gt;mcp-windbg 0.10.0: Now Available on PyPI&lt;/h2&gt;
&lt;p&gt;Five months after the initial release of &lt;a href=&quot;/posts/ai-meets-windbg/&quot;&gt;mcp-windbg&lt;/a&gt;, I'm releasing version 0.10.0 with significant improvements and simplified deployment.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;mcp-windbg is now officially available on &lt;a href=&quot;https://pypi.org/project/mcp-windbg/&quot;&gt;PyPI&lt;/a&gt;.&lt;/strong&gt; Installation no longer requires cloning repositories or setting up development environments:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; mcp-windbg&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;This represents a significant simplification from the original setup process described in &lt;a href=&quot;/posts/ai-meets-windbg/&quot;&gt;my first article&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Additionally, mcp-windbg is now listed on the &lt;a href=&quot;https://github.com/modelcontextprotocol/registry&quot;&gt;official Model Context Protocol registry&lt;/a&gt;, which should improve discoverability and enable integrations with various MCP-compatible tools.&lt;/p&gt;
&lt;h2 id=&quot;release-0100-key-features-and-improvements&quot;&gt;Release 0.10.0: Key Features and Improvements&lt;/h2&gt;
&lt;p&gt;Version 0.10.0 incorporates community feedback and focuses on improving usability across different experience levels with debugging tools.&lt;/p&gt;
&lt;h3 id=&quot;new-features&quot;&gt;New Features&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Live Debugging Sessions&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Added &lt;code&gt;open_windbg_remote&lt;/code&gt; and &lt;code&gt;close_windbg_remote&lt;/code&gt; functions&lt;/li&gt;
&lt;li&gt;Support for connecting to live processes beyond crash dump analysis&lt;/li&gt;
&lt;li&gt;Real-time debugging through conversational AI interface&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Extended Dump File Support&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Full compatibility with &lt;code&gt;.mdmp&lt;/code&gt; and &lt;code&gt;.hdmp&lt;/code&gt; formats&lt;/li&gt;
&lt;li&gt;Microsoft Store WinDbg CDB compatibility&lt;/li&gt;
&lt;li&gt;Improved automatic discovery of crash dump files&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Development Infrastructure&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Migrated to &lt;code&gt;uv&lt;/code&gt; package manager for improved build performance&lt;/li&gt;
&lt;li&gt;Significantly reduced development setup and build times&lt;/li&gt;
&lt;li&gt;Streamlined dependency management&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;community-contributions&quot;&gt;Community Contributions&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;@sooknarine&lt;/strong&gt; contributed several key improvements that made this release possible:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/svnscha/mcp-windbg/pull/6&quot;&gt;#6: Find local dumps with other common extensions&lt;/a&gt;&lt;/strong&gt; - Enhanced automatic discovery of crash dump files&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/svnscha/mcp-windbg/pull/10&quot;&gt;#10: Add support for remote debugging&lt;/a&gt;&lt;/strong&gt; - Implemented live debugging session support&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These contributions demonstrate the value of community involvement in open source development.&lt;/p&gt;
&lt;h3 id=&quot;infrastructure-improvements&quot;&gt;Infrastructure Improvements&lt;/h3&gt;
&lt;p&gt;Several behind-the-scenes improvements enhance reliability and maintainability:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Continuous Integration&lt;/strong&gt;: Automated testing across Python versions 3.10 through 3.14&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Dependency Management&lt;/strong&gt;: Automated security updates and dependency maintenance&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Release Process&lt;/strong&gt;: Streamlined deployment for faster delivery of updates&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;documentation-updates&quot;&gt;Documentation Updates&lt;/h3&gt;
&lt;p&gt;The documentation has been restructured for better usability:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;AGENTS.md&lt;/strong&gt;: Comprehensive debugging instructions specifically for AI assistants&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Structured Templates&lt;/strong&gt;: &lt;code&gt;.github/prompts/dump-triage.prompt.md&lt;/code&gt; for consistent crash analysis (inspired by my &lt;a href=&quot;/posts/howto-extend-copilot-with-prompt-files/&quot;&gt;prompt engineering article&lt;/a&gt;)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Repository Wiki&lt;/strong&gt;: All documentation now lives in an easily searchable wiki&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Simplified README&lt;/strong&gt;: Focused on getting you started in minutes, not hours&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;This Changelog&lt;/strong&gt;: So you know what's changing and why&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;installation-from-tedious-to-trivial&quot;&gt;Installation: From Tedious to Trivial&lt;/h2&gt;
&lt;p&gt;Remember the old installation process? Clone, setup virtual environment, install dependencies, configure paths... ugh.&lt;/p&gt;
&lt;p&gt;Here's the new process:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A9955&quot;&gt;# Install mcp-windbg&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt; mcp-windbg&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A9955&quot;&gt;# That's it. Seriously.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Then add this to your &lt;code&gt;.vscode/mcp.json&lt;/code&gt;:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;json&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;	&quot;servers&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;		&quot;mcp_windbg&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;			&quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;stdio&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;			&quot;command&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;python&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;			&quot;args&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: [&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;				&quot;-m&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;				&quot;mcp_windbg&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;			],&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;			&quot;env&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;				&quot;_NT_SYMBOL_PATH&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;SRV*C:&lt;/span&gt;&lt;span style=&quot;color:#D7BA7D&quot;&gt;\\&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;Symbols*https://msdl.microsoft.com/download/symbols&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;The installation process is now considerably simplified compared to the previous manual setup requirements.&lt;/p&gt;
&lt;h2 id=&quot;next-steps&quot;&gt;Next Steps&lt;/h2&gt;
&lt;p&gt;With 0.10.0 released, these are the next areas I plan to work on:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;More AI integrations&lt;/strong&gt; beyond VS Code&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Enhanced live debugging capabilities&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Performance optimizations&lt;/strong&gt; for large dump files&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Community-requested features&lt;/strong&gt; (keep them coming!)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The development roadmap will continue to incorporate community feedback and feature requests.&lt;/p&gt;
&lt;h2 id=&quot;getting-started&quot;&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;To begin using mcp-windbg 0.10.0:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Install&lt;/strong&gt;: &lt;code&gt;pip install mcp-windbg&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Configure&lt;/strong&gt;: Add the MCP server to your VS Code configuration&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Use&lt;/strong&gt;: Load crash dumps and interact through natural language queries&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Contribute&lt;/strong&gt;: Report issues, suggest features, or contribute code improvements&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Links:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;GitHub Repository&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://pypi.org/project/mcp-windbg/&quot;&gt;PyPI Package&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/modelcontextprotocol/registry&quot;&gt;MCP Registry Listing&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/posts/ai-meets-windbg/&quot;&gt;Article: AI Meets WinDbg&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/posts/howto-extend-copilot-with-prompt-files/&quot;&gt;Article: Prompt Engineering with Copilot&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;community-response-and-impact&quot;&gt;Community Response and Impact&lt;/h2&gt;
&lt;p&gt;Since the initial release in May, the project has received significant community engagement. The &lt;a href=&quot;/posts/ai-meets-windbg/&quot;&gt;original article&lt;/a&gt; generated over 40,000 page views within the first two days, along with thousands of LinkedIn impressions and direct messages from developers worldwide.&lt;/p&gt;
&lt;p&gt;The feedback has been constructive and encouraging. Developers have shared how the tool helped reduce time spent on crash analysis, and several teams have integrated it into their debugging workflows. I've had opportunities to present this work both internally and externally, leading to valuable discussions about AI-assisted development tools.&lt;/p&gt;
&lt;p&gt;The open source community response has been particularly gratifying. Contributors like &lt;a href=&quot;https://github.com/sooknarine&quot;&gt;@sooknarine&lt;/a&gt; have stepped in to add functionality that benefits all users. The GitHub repository has gained considerable attention, and the project's inclusion in the official MCP registry should further improve its discoverability.&lt;/p&gt;
&lt;p&gt;Building something that genuinely helps other developers solve real problems has been rewarding beyond what I expected when I first started working on this as a way to improve my own debugging workflow.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;Thanks to everyone who has contributed, shared feedback, or simply tried the tool. The community response has made this project much better than it would have been otherwise.&lt;/em&gt;&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>How to extend GitHub Copilot with prompt files</title>
        <published>2025-09-10T00:00:00+00:00</published>
        <updated>2025-09-10T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/howto-extend-copilot-with-prompt-files/"/>
        <id>https://svnscha.de/posts/howto-extend-copilot-with-prompt-files/</id>
        <summary type="html">Because copy-pasting prompts from your notes app is so last year. Let me show you how to turn your best prompts into reusable superpowers.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/howto-extend-copilot-with-prompt-files/">&lt;h2 id=&quot;why-you-ask&quot;&gt;Why, You Ask?&lt;/h2&gt;
&lt;p&gt;Remember when I went absolutely euphoric about &lt;a href=&quot;/posts/vscode-vibe-coding/&quot;&gt;vibe coding&lt;/a&gt;? Well, that honeymoon phase taught me one crucial lesson: &lt;strong&gt;context matters, and you really need to spend time writing good prompts.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;At first, I was frantically scribbling prompts in my notes app like some kind of digital hoarder. Then I graduated to GitHub Copilot instruction files, adding rules like &quot;when asked for review, do this and that.&quot; But constantly switching between apps and copy-pasting prompts? &lt;strong&gt;I'm tired of it.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;GitHub Copilot's prompt files solve this by keeping reusable instructions in the repository.&lt;/p&gt;
&lt;h2 id=&quot;using-promptmd-files&quot;&gt;Using &lt;code&gt;.prompt.md&lt;/code&gt; Files&lt;/h2&gt;
&lt;p&gt;Prompt files turn your best prompts into reusable slash commands. VS Code gives you two flavors:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Workspace prompts&lt;/strong&gt; (&lt;code&gt;.github/prompts/&lt;/code&gt;): Travel with your repository, perfect for team-shared helpers&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;User prompts&lt;/strong&gt;: Stored in your VS Code profile, available everywhere for personal tools&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Both become accessible as &lt;code&gt;/my-prompt&lt;/code&gt; directly in VS Code chat. Instead of hunting through notes for that brilliant review prompt, you just type &lt;code&gt;/svnscha-blog-review&lt;/code&gt; and boom, there it is.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; Prompt files are currently in public preview and may change in future releases.&lt;/p&gt;
&lt;h2 id=&quot;real-world-example-blog-review-prompt&quot;&gt;Real-World Example: Blog Review Prompt&lt;/h2&gt;
&lt;p&gt;Let me show you what this looks like in practice. I use project prefixes for workspace prompts and &lt;code&gt;/my-...&lt;/code&gt; for personal ones.&lt;/p&gt;
&lt;p&gt;For this blog, I created &lt;code&gt;/svnscha-blog-review&lt;/code&gt; - a specialized prompt that understands my writing style:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;markdown&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;mode&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;agent&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;Review blog posts for svnscha.github.io with focus on style, grammar, and technical accuracy&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6;font-weight:bold&quot;&gt;# Blog Post Review for svnscha.github.io&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;You are an expert editor reviewing a blog post for svnscha's technical blog.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;Focus on:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6;font-weight:bold&quot;&gt;## Writing Style &amp;amp; Tone&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Consider using &quot;Why, You Ask?&quot; openings when it makes sense for the topic (not mandatory for all posts)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Keep the direct, slightly sarcastic but helpful voice&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Ensure smooth transitions between sections&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; End posts with a short summary or practical next steps when they add value&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6;font-weight:bold&quot;&gt;## Technical Accuracy&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Verify code examples are correct and practical&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Check that technical explanations are clear and accurate&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Ensure all file paths and commands are properly formatted&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6;font-weight:bold&quot;&gt;## Grammar &amp;amp; Spelling&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Fix any grammatical errors or typos&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Improve sentence structure where needed&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Maintain consistency in technical terminology&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6;font-weight:bold&quot;&gt;## Content Structure&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Ensure headings flow logically&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Verify examples support the main points&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Suggest a brief summary or actionable next steps when appropriate&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Check that the conclusion ties back to the opening&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;Provide specific, actionable feedback that maintains the author's voice while improving clarity and correctness.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;This becomes available as &lt;code&gt;/svnscha-blog-review&lt;/code&gt; in VS Code, giving me instant access to a specialized editor that knows my style.&lt;/p&gt;
&lt;h2 id=&quot;smart-naming--location-strategy&quot;&gt;Smart Naming &amp;amp; Location Strategy&lt;/h2&gt;
&lt;p&gt;The naming convention is simple: &lt;strong&gt;project prefixes for workspace prompts, &lt;code&gt;/my-...&lt;/code&gt; for personal ones.&lt;/strong&gt; So &lt;code&gt;/svnscha-blog-review&lt;/code&gt; is specific to this blog, while &lt;code&gt;/my-commit&lt;/code&gt; works everywhere.&lt;/p&gt;
&lt;p&gt;Choose your location based on scope:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Workspace prompts&lt;/strong&gt;: Team-shared, project-specific helpers&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;User prompts&lt;/strong&gt;: Personal tools that follow you across all projects&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;dynamic-prompts-with-variables&quot;&gt;Dynamic Prompts with Variables&lt;/h2&gt;
&lt;p&gt;Make your prompts adapt to context with VS Code variables:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;markdown&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6;font-weight:bold&quot;&gt;# Code Review Prompt&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;Review the following code in ${file}:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;${selection}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;Focus on:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Security vulnerabilities in ${fileBasename}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Performance implications &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6796E6&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; Code style consistency with ${workspaceFolderBasename} standards&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;The most useful variables include:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Workspace&lt;/strong&gt;: &lt;code&gt;${workspaceFolder}&lt;/code&gt;, &lt;code&gt;${workspaceFolderBasename}&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;File context&lt;/strong&gt;: &lt;code&gt;${file}&lt;/code&gt;, &lt;code&gt;${fileBasename}&lt;/code&gt;, &lt;code&gt;${fileDirname}&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Selection&lt;/strong&gt;: &lt;code&gt;${selection}&lt;/code&gt;, &lt;code&gt;${selectedText}&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;For the full list of available variables and advanced features, check out the &lt;a href=&quot;https://code.visualstudio.com/docs/copilot/customization/prompt-files&quot;&gt;VS Code prompt files documentation&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;setting-up-your-prompt-arsenal&quot;&gt;Setting Up Your Prompt Arsenal&lt;/h2&gt;
&lt;p&gt;Getting started is simple:&lt;/p&gt;
&lt;h3 id=&quot;workspace-prompts&quot;&gt;Workspace Prompts&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;Create &lt;code&gt;.github/prompts/&lt;/code&gt; in your repository&lt;/li&gt;
&lt;li&gt;Add your &lt;code&gt;.prompt.md&lt;/code&gt; files&lt;/li&gt;
&lt;li&gt;Commit and push - your team now has access&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;user-prompts&quot;&gt;User Prompts&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;Open Command Palette (&lt;code&gt;Ctrl+Shift+P&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Run &quot;Chat: New Prompt File&quot;&lt;/li&gt;
&lt;li&gt;Choose &quot;User profile&quot; for location&lt;/li&gt;
&lt;li&gt;Author and save your prompt&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Both methods make prompts available with &lt;code&gt;/prompt-name&lt;/code&gt; in GitHub Copilot chat. Workspace prompts travel with your repository, while user prompts sync across devices with Settings Sync.&lt;/p&gt;
&lt;p&gt;For examples and community contributions, check out the &lt;a href=&quot;https://github.com/github/awesome-copilot/tree/main/prompts&quot;&gt;Awesome GitHub Copilot prompts collection&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;summary&quot;&gt;Summary&lt;/h2&gt;
&lt;p&gt;Prompt files transform good prompting from an exclusive skill into a shared superpower. Your team gets expert-level guidance, your hotfix deployments get proper review, and your collective wisdom becomes instantly accessible with slash commands.&lt;/p&gt;
&lt;h2 id=&quot;next-steps&quot;&gt;Next Steps&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Start small&lt;/strong&gt; - Convert your three most-used prompts to &lt;code&gt;.prompt.md&lt;/code&gt; files&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Choose scope wisely&lt;/strong&gt; - Workspace prompts for teams, user prompts for personal tools&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Use variables&lt;/strong&gt; - Make prompts dynamic with &lt;code&gt;${selection}&lt;/code&gt;, &lt;code&gt;${file}&lt;/code&gt;, and &lt;code&gt;${input:variableName}&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Follow naming conventions&lt;/strong&gt; - Project prefixes for workspace, &lt;code&gt;/my-...&lt;/code&gt; for user prompts&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Explore the community&lt;/strong&gt; - Check out &lt;a href=&quot;https://github.com/github/awesome-copilot/tree/main/prompts&quot;&gt;Awesome GitHub Copilot prompts&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Read the docs&lt;/strong&gt; - &lt;a href=&quot;https://code.visualstudio.com/docs/copilot/customization/prompt-files&quot;&gt;VS Code prompt files documentation&lt;/a&gt; has the latest features&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The main benefit is simple: useful instructions live with the project and can be reused without copying them into every chat.&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>AI Meets WinDBG: A Different Way to Analyze Crashes</title>
        <published>2025-05-04T00:00:00+00:00</published>
        <updated>2025-05-04T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/ai-meets-windbg/"/>
        <id>https://svnscha.de/posts/ai-meets-windbg/</id>
        <summary type="html">Because manually squinting at hex dumps is so last century. Let me show you how AI-assisted debugging is leaving WinDBG's command line in the dust.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/ai-meets-windbg/">&lt;h2 id=&quot;old-meets-new-bringing-crash-analysis-into-2025&quot;&gt;Old Meets New: Bringing Crash Analysis into 2025&lt;/h2&gt;
&lt;p&gt;Let's face it - while the rest of software development has evolved at warp speed, crash dump analysis feels like it's been preserved in digital amber for decades. We've got self-driving cars and pocket-sized supercomputers, yet here we are, still pecking away at command prompts like it's the dawn of the internet. Why is debugging the only area where we cling to tools that look like they belong in a computer history museum?&lt;/p&gt;
&lt;p&gt;Picture this: You, a professional software engineer in 2025, hunched over a terminal, manually typing arcane commands like &lt;code&gt;!analyze -v&lt;/code&gt; and &lt;code&gt;.ecxr&lt;/code&gt;, squinting at hexadecimal memory addresses, and mentally translating stack traces. All while your friends in other industries are delegating their work to AI assistants that can write entire documents, create art, or automate complex workflows.&lt;/p&gt;
&lt;p&gt;Something's wrong with this picture, right?&lt;/p&gt;
&lt;p&gt;I wanted a simpler workflow: ask questions in plain language and let an AI assistant run the relevant debugger commands. This is more than a new interface for WinDBG; it changes how you interact with the debugger.&lt;/p&gt;
&lt;h2 id=&quot;when-inspiration-strikes&quot;&gt;When Inspiration Strikes&lt;/h2&gt;
&lt;p&gt;During a debugging session at work, I had one of those lightning bolt moments. What if - and stick with me here - we could apply the same AI-assisted &quot;vibe coding&quot; approach to crash dump analysis?&lt;/p&gt;
&lt;p&gt;Picture this: instead of manually slogging through memory dumps and command outputs, you simply ask, &quot;Hey, why did this application crash?&quot; and get an intelligent, contextual answer that actually helps you solve the problem.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;The idea was too compelling not to pursue. So I built it.&lt;/strong&gt;&lt;/p&gt;
&lt;h2 id=&quot;see-it-in-action-ai-powered-crash-analysis&quot;&gt;See It In Action: AI-Powered Crash Analysis&lt;/h2&gt;
&lt;p&gt;Before diving into the technical details, let me show you what this looks like in practice. I have prepared a demo application to showcase two different use cases:&lt;/p&gt;
&lt;h3 id=&quot;video-1-crash-analysis-and-automated-bugfix&quot;&gt;Video 1: Crash Analysis and Automated Bugfix&lt;/h3&gt;
&lt;p&gt;In this video, I show how Copilot can analyze a crash dump, identify the bug and auto-fix the issue.&lt;/p&gt;
&lt;video class=&quot;cast&quot; src=&quot;/casts/2025-05-03-CrashDump1.webm&quot; controls&gt;
  Your browser does not support the video tag.
&lt;/video&gt;
&lt;p&gt;As you can see in the video, instead of manually running WinDBG commands and interpreting the cryptic output, I'm having a natural conversation with GitHub Copilot. The AI quickly identifies that the application crashed, explains which specific conditions led to the crash, and suggests a fix.&lt;/p&gt;
&lt;h3 id=&quot;video-2-automated-crash-dump-analysis-of-multiple-crash-dump-files&quot;&gt;Video 2: Automated Crash Dump Analysis of multiple crash dump files&lt;/h3&gt;
&lt;p&gt;This video demonstrates a different capability: analyzing multiple crash dump files at once. It shows how the tool can quickly identify which dumps belong to your application and which don't.&lt;/p&gt;
&lt;video class=&quot;cast&quot; src=&quot;/casts/2025-05-03-CrashDump2.webm&quot; controls&gt;
  Your browser does not support the video tag.
&lt;/video&gt;
&lt;p&gt;Worth noting, it takes just a few seconds until you get your first useful answer. I've played around with this for many hours and let me tell you one thing: You can really go deep. If you ask the right questions, the AI runs WinDBG/CDB commands that I haven't seen in all these years of debugging, and that is simply amazing.&lt;/p&gt;
&lt;h2 id=&quot;how-can-this-help-the-industry&quot;&gt;How can this help the industry?&lt;/h2&gt;
&lt;p&gt;I believe this is one of the really good examples of how AI can boost productivity. Analyzing crash dumps is a very tedious task. It begins with quickly checking and identifying whether crashes are the same or different, and often requires very advanced knowledge when a crash is challenging - really challenging.&lt;/p&gt;
&lt;p&gt;Copilot can help here tremendously; it knows how to:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Interpret assembly code (without you having to remember what EAX stands for)&lt;/li&gt;
&lt;li&gt;Check memory contents (so you don't have to count hex bytes on your fingers)&lt;/li&gt;
&lt;li&gt;Traverse structures with symbols (goodbye to manual pointer arithmetic!)&lt;/li&gt;
&lt;li&gt;And so much more&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;This can help engineers, support teams, and QA staff work with crash dumps without memorizing every debugger command.&lt;/p&gt;
&lt;h2 id=&quot;how-did-i-build-this&quot;&gt;How did I build this?&lt;/h2&gt;
&lt;p&gt;If you've ever worked with WinDBG, you know the drill: cryptic commands, obscure syntax, and endless scrolling through memory addresses and stack traces that make your eyes glaze over. It's the kind of specialized knowledge that takes years to master and feels like speaking an alien language even when you do.&lt;/p&gt;
&lt;p&gt;The trick here is connecting WinDBG with AI. To do that, you first need to programmatically control a debugging session, right? There are plenty of options on how to do this. I prefer to keep things simple, so I have chosen &lt;a href=&quot;https://learn.microsoft.com/en-us/windows-hardware/drivers/debugger/debugging-using-cdb-and-ntsd&quot;&gt;CDB&lt;/a&gt;, which is Microsoft's Console Debugger. It operates on standard input and output, and that's so much more fun to deal with than setting up COM APIs or similar approaches.&lt;/p&gt;
&lt;p&gt;The second part is &quot;connecting with AI.&quot; That's where Model Context Protocol Servers come into the game.&lt;/p&gt;
&lt;h2 id=&quot;understanding-model-context-protocol-servers&quot;&gt;Understanding Model Context Protocol Servers&lt;/h2&gt;
&lt;p&gt;MCP is an open standard developed by Anthropic, released in November 2024. This protocol allows AI models to interact with external tools and data sources - think of it as giving AI assistants &quot;hands&quot; to work with other software. It defines a way for AI assistants to discover, access, and use tools through a consistent interface. In essence, it's what allows GitHub Copilot to &quot;talk&quot; to external programs like WinDBG.&lt;/p&gt;
&lt;p&gt;An MCP server acts as the intermediary between the AI model and the tool. It:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Registers available tools with the client&lt;/li&gt;
&lt;li&gt;Handles requests from AI models to use these tools&lt;/li&gt;
&lt;li&gt;Executes the tool operations and returns results&lt;/li&gt;
&lt;li&gt;Maintains context across interactions&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Any tool can be made available to an AI model through an MCP server. I built one for WinDBG's CDB debugger.&lt;/p&gt;
&lt;h3 id=&quot;why-mcp-instead-of-languagemodeltool-api&quot;&gt;Why MCP Instead of LanguageModelTool API?&lt;/h3&gt;
&lt;p&gt;The &lt;a href=&quot;https://code.visualstudio.com/api/extension-guides/tools&quot;&gt;LanguageModelTool API&lt;/a&gt; might eventually be a better fit for this specific use-case. Creating a Visual Studio Extension that &quot;just works&quot; out of the box would potentially simplify the integration process significantly.&lt;/p&gt;
&lt;p&gt;However, using MCP directly offers several notable advantages. It works with any AI model, not just limiting itself to Copilot. The server can be used outside VS Code, functioning with various other tools. New features can be easily added without necessitating changes to the core integration. Moreover, it remains platform-independent, avoiding lock-in to any single company's implementation.&lt;/p&gt;
&lt;h2 id=&quot;the-mcp-windbg-project&quot;&gt;The MCP-WinDBG Project&lt;/h2&gt;
&lt;p&gt;I've implemented a &lt;a href=&quot;https://www.anthropic.com/news/model-context-protocol&quot;&gt;Model Context Protocol&lt;/a&gt; server that wraps WinDBG/CDB and exposes its capabilities to AI models within VS Code. Better yet, I've made it open source so everyone can experience this new workflow.&lt;/p&gt;
&lt;p&gt;The project, &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;mcp-windbg&lt;/a&gt;, connects VS Code and GitHub Copilot to WinDBG's analysis commands.&lt;/p&gt;
&lt;p&gt;The actual &quot;hard part&quot; was implementing the CDB (Command-Line WinDBG) interaction layer. And by &quot;hard&quot;, I mean vibe-coding with two coffees on a Saturday morning, where I spent more time being annoyed by pyTest failures than actual coding difficulties. The core implementation came together surprisingly quickly!&lt;/p&gt;
&lt;p&gt;The rest is primarily wrapper code that implements the Model Context Protocol specifications. Now that I've established and defined the core WinDBG interaction logic, I'm considering refactoring the project to TypeScript. This would enable me to create both an MCP Server in TypeScript and a dedicated Visual Studio Extension, with both implementations leveraging the same underlying CDB interaction layer.&lt;/p&gt;
&lt;h2 id=&quot;what-does-this-mean-in-practice&quot;&gt;What Does This Mean In Practice?&lt;/h2&gt;
&lt;p&gt;Let me walk you through what this enables:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Natural language crash analysis&lt;/strong&gt;: &quot;Why is this application crashing with an access violation at this address?&quot; (Instead of: &quot;What the $%#@ is this heap corruption!?&quot;)&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Contextual debugging&lt;/strong&gt;: &quot;Show me the stack trace for thread 5 and explain what each function is doing based on the symbols.&quot; (Instead of staring at call stacks like they're ancient hieroglyphics)&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Root cause identification&lt;/strong&gt;: &quot;What's causing this null pointer dereference and where should I look in the code to fix it?&quot; (Instead of playing detective with memory addresses)&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Instead of typing obscure commands like &lt;code&gt;!analyze -v&lt;/code&gt; followed by a series of manual investigations, you simply ask questions in plain language, and the AI interprets the crash data for you. It's like having a WinDBG expert whispering in your ear, except it doesn't get annoyed when you ask the same question five times.&lt;/p&gt;
&lt;h2 id=&quot;how-it-works&quot;&gt;How It Works&lt;/h2&gt;
&lt;p&gt;The MCP server connects GitHub Copilot to WinDBG:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;It provides a set of tools that Copilot can use to interact with crash dumps&lt;/li&gt;
&lt;li&gt;It translates natural language questions into appropriate WinDBG commands&lt;/li&gt;
&lt;li&gt;It parses and interprets the often cryptic WinDBG output into more useful information&lt;/li&gt;
&lt;li&gt;It maintains context throughout a debugging session, enabling follow-up questions to work naturally&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The technical implementation uses Python to spawn and communicate with CDB (the command-line version of WinDBG), parses the output, and exposes the functionality through the Model Context Protocol to VS Code.&lt;/p&gt;
&lt;h2 id=&quot;getting-started-with-mcp-windbg&quot;&gt;Getting Started With mcp-windbg&lt;/h2&gt;
&lt;p&gt;Ready to try it yourself? Here's how to get started:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;First, make sure you have the Windows SDK installed with Debugging Tools for Windows&lt;/li&gt;
&lt;li&gt;Clone the repository: &lt;code&gt;git clone https://github.com/svnscha/mcp-windbg.git&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Set up a Python virtual environment and install the package&lt;/li&gt;
&lt;li&gt;Configure VS Code to use the MCP server&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;For complete details, check out the &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;repository README&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Once configured, create a &lt;code&gt;.vscode/mcp.json&lt;/code&gt; file in your project that points to the server:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;json&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;    &quot;servers&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;        &quot;mcp_server_windbg&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;            &quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;stdio&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;            &quot;command&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;python&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;            &quot;args&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: [&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;                &quot;-m&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;                &quot;mcp_server_windbg&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;            ],&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;            &quot;env&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;                &quot;_NT_SYMBOL_PATH&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;SRV*C:&lt;/span&gt;&lt;span style=&quot;color:#D7BA7D&quot;&gt;\\&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;Symbols*https://msdl.microsoft.com/download/symbols&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;        },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;You might need to update the command, depending on where and how you have installed the mcp_server_windbg to.&lt;/p&gt;
&lt;h2 id=&quot;the-human-touch-still-matters&quot;&gt;The Human Touch Still Matters&lt;/h2&gt;
&lt;p&gt;Just like with &lt;a href=&quot;/posts/vscode-vibe-coding/&quot;&gt;code refactoring&lt;/a&gt;, the AI assistance isn't perfect. The human element - your experience, intuition, and domain knowledge - remains crucial. Sometimes you'll need to guide the analysis, ask follow-up questions, or provide additional context.&lt;/p&gt;
&lt;p&gt;The useful part is the combination: AI can process a large amount of debugger output quickly, while you provide the context needed to judge the result. It still needs supervision and can follow the wrong lead, so treat its findings as a starting point rather than a final answer.&lt;/p&gt;
&lt;h2 id=&quot;join-the-experience&quot;&gt;Join The Experience&lt;/h2&gt;
&lt;p&gt;I'd love for you to try this out, contribute to the project, and share your experiences. If you're interested:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Star the &lt;a href=&quot;https://github.com/svnscha/mcp-windbg&quot;&gt;GitHub repository&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Try it on your own crash dumps&lt;/li&gt;
&lt;li&gt;Report issues, suggest improvements, or contribute code&lt;/li&gt;
&lt;li&gt;Share your success stories (or even failures - we learn from those too!)&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;the-magic-is-in-the-flow&quot;&gt;The Magic Is In The Flow&lt;/h2&gt;
&lt;p&gt;Just like with my code refactoring experience, the real magic isn't about any single capability - it's about the flow. When debugging stops being a tedious chore and becomes a fluid conversation, something fundamentally changes in how you approach problem-solving.&lt;/p&gt;
&lt;p&gt;Gone are the days of dreading crash analysis. Instead, each debugging session becomes an opportunity for collaboration with an AI partner that helps you understand what's happening at a deeper level.&lt;/p&gt;
&lt;h2 id=&quot;summary&quot;&gt;Summary&lt;/h2&gt;
&lt;p&gt;Crash dump analysis has traditionally been one of the most technically demanding and least enjoyable parts of software development. It's like archaeology with a keyboard - painstakingly excavating through layers of memory and CPU state to unearth what went wrong. With AI assistance through tools like mcp-windbg, it becomes another area where we can experience that perfect &quot;vibe state&quot; of frictionless problem-solving.&lt;/p&gt;
&lt;p&gt;If you're still manually typing WinDBG commands and squinting at memory dumps in 2025, you're not just missing out on productivity - you're missing out on a fundamentally more enjoyable way to work.&lt;/p&gt;
&lt;p&gt;Try it. Debug it. Vibe it.&lt;/p&gt;
</content>
    </entry>
    <entry xml:lang="en">
        <title>Vibe Coding is So Damn Real</title>
        <published>2025-04-27T00:00:00+00:00</published>
        <updated>2025-04-27T00:00:00+00:00</updated>
        <author>
          <name>Sven Scharmentke</name>
        </author>
        <link rel="alternate" type="text/html" href="https://svnscha.de/posts/vscode-vibe-coding/"/>
        <id>https://svnscha.de/posts/vscode-vibe-coding/</id>
        <summary type="html">Because watching GitHub Copilot refactor files with a single prompt is the most satisfying thing you'll see today.</summary>
        <content type="html" xml:base="https://svnscha.de/posts/vscode-vibe-coding/">&lt;h2 id=&quot;why-you-ask&quot;&gt;Why, You Ask?&lt;/h2&gt;
&lt;p&gt;Ever had that moment when your coding flow is so perfect it feels like you and your tools are in some kind of cosmic alignment? That's vibe coding. It's when the friction between thought and implementation practically disappears. And let me tell you, with GitHub Copilot and VS Code, this isn't just a fleeting sensation-it's a consistent reality.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;I'm tired of writing about theoretical capabilities. Let me show you something concrete.&lt;/strong&gt;&lt;/p&gt;
&lt;h2 id=&quot;a-childhood-dream-come-true&quot;&gt;A Childhood Dream Come True&lt;/h2&gt;
&lt;p&gt;Let me share something personal: since I first started coding, I've had this recurring dream. A dream where I could simply talk to my computer, tell it what I want in plain language, and watch as it translates my intentions into working code. No syntax gymnastics. No hunting for semicolons. Just pure, frictionless creation.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&quot;Hey computer, refactor this module to use dependency injection instead of globals.&quot;&lt;/li&gt;
&lt;li&gt;&quot;Computer, optimize this database query, it's running too slow.&quot;&lt;/li&gt;
&lt;li&gt;&quot;Add translation support to all user-facing strings in this module.&quot;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;For decades, this remained firmly in the realm of science fiction-something for Star Trek episodes where they casually ask the computer to &quot;reconfigure the deflector dish&quot; and it just... happens.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;DAMN, we're just there now.&lt;/strong&gt; Not in some distant future, not as a tech demo, but as a practical, everyday reality in my development workflow.&lt;/p&gt;
&lt;h2 id=&quot;real-world-context-nofidoc&quot;&gt;Real-World Context: Nofidoc&lt;/h2&gt;
&lt;p&gt;A little context: In my free time, I've been pushing the boundaries of what's possible with AI-assisted coding-well beyond just casual experiments. While I also use these workflows at work, Nofidoc has become my personal playground for exploring how far I can take this technology. It's a space where I can try things that aren't always ready for the spotlight, but the results have been too compelling not to share (even if I'm keeping things a bit low-key for now).&lt;/p&gt;
&lt;p&gt;The codebase uses Qt for the UI components, has a wizard-based document import flow, and handles various document formats with a focus on PDFs. It's exactly the kind of mid-sized C++ project where refactoring used to be tedious and error-prone.&lt;/p&gt;
&lt;h2 id=&quot;the-perfect-pairing&quot;&gt;The Perfect Pairing&lt;/h2&gt;
&lt;p&gt;VS Code with GitHub Copilot doesn't just assist your coding-it transforms it. No more wasting precious brain cycles on trivial tasks. No more tedious refactoring operations that make you question your career choices at 2 AM.&lt;/p&gt;
&lt;p&gt;I recently needed to refactor the document import workflow to remove direct database dependencies in the wizard component. Why having that in the first place? Well, getting something proof-of-concept-ish is the answer. Anyways, this is a classic case of improving architecture by decoupling components, but it typically requires careful changes across multiple files and understanding the entire call hierarchy.&lt;/p&gt;
&lt;h2 id=&quot;see-the-entire-workflow-in-action&quot;&gt;See The Entire Workflow In Action&lt;/h2&gt;
&lt;p&gt;I've recorded a full ~6-minute video showing the entire refactoring process from start to finish. You'll see me:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Prompt Copilot with my refactoring requirements&lt;/li&gt;
&lt;li&gt;Watch the initial code changes being proposed&lt;/li&gt;
&lt;li&gt;Hit compilation errors (because real-world code is messy!)&lt;/li&gt;
&lt;li&gt;Provide additional guidance to Copilot&lt;/li&gt;
&lt;li&gt;Get a complete, working solution&lt;/li&gt;
&lt;/ol&gt;
&lt;video class=&quot;cast&quot; src=&quot;/casts/2025-04-27-vibe.webm&quot; controls&gt;
  Your browser does not support the video tag.
&lt;/video&gt;
&lt;p&gt;What's remarkable here is not just that Copilot could make the changes, but how the entire interaction feels like working with a senior developer who deeply understands your codebase.&lt;/p&gt;
&lt;h2 id=&quot;the-real-example-documentimportwizard-refactoring&quot;&gt;The Real Example: DocumentImportWizard Refactoring&lt;/h2&gt;
&lt;p&gt;Here's a snapshot of what happened in the video. I needed to update the DatabaseWidget class to use the new API of our DocumentImportWizard that we had refactored to remove direct database dependencies.&lt;/p&gt;
&lt;p&gt;Copilot analyzed the code and came up with this solution:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;cpp&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A9955&quot;&gt;// Before refactoring, direct database dependency:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;void&lt;/span&gt;&lt;span style=&quot;color:#4EC9B0&quot;&gt; DatabaseWidget&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;::&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;onDocumentImportWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;    auto&lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt; importWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; = &lt;/span&gt;&lt;span style=&quot;color:#C586C0&quot;&gt;new&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt; DocumentImportWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;_database&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;this&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;    importWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;-&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;exec&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A9955&quot;&gt;// After refactoring, using callback approach:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;void&lt;/span&gt;&lt;span style=&quot;color:#4EC9B0&quot;&gt; DatabaseWidget&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;::&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;onDocumentImportWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;    auto&lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt; importWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; = &lt;/span&gt;&lt;span style=&quot;color:#C586C0&quot;&gt;new&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt; DocumentImportWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;this&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;    importWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;-&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;setGetDocumentTypesCallback&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;([&lt;/span&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;this&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;]() {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#C586C0&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; (!&lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;_database&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#C586C0&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt; QList&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#4EC9B0&quot;&gt;DocumentType&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;&amp;gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;        auto&lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt; docTypeService&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; = &lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;_database&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;-&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;getDocumentTypeService&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#C586C0&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt; (!&lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;docTypeService&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#C586C0&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt; QList&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#4EC9B0&quot;&gt;DocumentType&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;&amp;gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#C586C0&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt; docTypeService&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;-&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;getDocumentTypes&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;    });&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9CDCFE&quot;&gt;    importWizard&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;-&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;exec&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Copilot explained its reasoning:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;&quot;I've updated the onDocumentImportWizard() method in DatabaseWidget to use the new refactored API of our DocumentImportWizard class. The key changes were:&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;1. Removed passing the _database parameter directly to the DocumentImportWizard constructor&lt;/em&gt;
&lt;em&gt;2. Added a call to setGetDocumentTypesCallback() with a lambda that:&lt;/em&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Checks if _database is valid&lt;/li&gt;
&lt;li&gt;Gets the document type service from the database&lt;/li&gt;
&lt;li&gt;Returns the document types list from the service&lt;/li&gt;
&lt;li&gt;Returns an empty list if any step fails&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;em&gt;This completes the refactoring work by updating all the calling code to use the new API. The change maintains the same functionality but with a cleaner design that removes direct dependencies on the database pointer.&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;The implementation follows modern C++ practices by using a lambda to encapsulate the specific functionality needed (getting document types) while keeping the rest of the database access logic out of the wizard class. This makes the code more maintainable and easier to test.&quot;&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;This is exactly the kind of architectural improvement that typically takes deep understanding of both the codebase and software design principles. Yet Copilot produced it in seconds.&lt;/p&gt;
&lt;h2 id=&quot;the-key-lesson-human-ai-collaboration&quot;&gt;The Key Lesson: Human-AI Collaboration&lt;/h2&gt;
&lt;p&gt;My main takeaway is simple: &lt;strong&gt;AI tools work best when you bring your own domain knowledge.&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Just before that, I was debugging a frustrating issue with field registration in that document import wizard. The fields weren't passing values between pages correctly. I asked Copilot to help fix the bug and it initially proposed an overly complex workaround that would have been a maintenance nightmare.&lt;/p&gt;
&lt;p&gt;So I gave it a hint:&lt;/p&gt;
&lt;p&gt;&quot;I think there's an issue with the registerField calls for 'importSuccessCount' and 'importErrorCount'. The implementation doesn't specify the property name correctly.&quot;&lt;/p&gt;
&lt;p&gt;And just like that, it had an &quot;aha!&quot; moment. It immediately identified the real issue:&lt;/p&gt;
&lt;pre class=&quot;astro-code dark-plus&quot; style=&quot;background-color:#1E1E1E;color:#D4D4D4; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;cpp&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A9955&quot;&gt;// Before (buggy implementation):&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;registerField&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;importSuccessCount&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;this&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A9955&quot;&gt;// After (Copilot's correct fix):&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#DCDCAA&quot;&gt;registerField&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;importSuccessCount&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#569CD6&quot;&gt;this&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#CE9178&quot;&gt;&quot;importSuccessCount&quot;&lt;/span&gt;&lt;span style=&quot;color:#D4D4D4&quot;&gt;);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;This simple fix resolved the entire issue. The fix works because it properly uses the Qt property system (third parameter) as the remaining code and pages expected, whereas Copilot's initial workaround was mega ugly - setting properties directly with setProperty() calls. With just a small hint about the actual problem, we were back on track. This perfectly illustrates why domain expertise remains critical - AI tools can suggest solutions, but knowing which ones make sense in your framework requires human judgment.&lt;/p&gt;
&lt;p&gt;Sometimes AI tools need a gentle nudge in the right direction, and then they're off to the races again.&lt;/p&gt;
&lt;h2 id=&quot;not-always-perfect-magic&quot;&gt;Not Always Perfect Magic&lt;/h2&gt;
&lt;p&gt;Let me be real with you - it's not all sunshine and rainbows. AI assistance sometimes misses the mark, and when it does, you need to steer it in the right direction. But I've found that:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;The initial attempt is usually close&lt;/li&gt;
&lt;li&gt;AI is exceptionally good at understanding feedback&lt;/li&gt;
&lt;li&gt;With the right hints, it can quickly recover and find the optimal solution&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The collaboration workflow is what makes all the difference. Instead of wrestling with a tool, it feels like having a junior developer who's eager to learn and quick to adapt.&lt;/p&gt;
&lt;h2 id=&quot;what-i-learned&quot;&gt;What I Learned&lt;/h2&gt;
&lt;p&gt;This isn't just about saving time (though I saved HOURS). It's about changing how we think about coding. When you can express your intent in natural language and have it accurately translated into code changes, you're no longer programming computers-you're conversing with them.&lt;/p&gt;
&lt;p&gt;The barrier between thinking and implementing just got so much thinner.&lt;/p&gt;
&lt;h2 id=&quot;getting-this-setup-yourself&quot;&gt;Getting This Setup Yourself&lt;/h2&gt;
&lt;p&gt;Want this superpower? Here's what you need:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;VS Code&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;GitHub Copilot&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A clear understanding of your codebase&lt;/strong&gt; - To craft effective prompts&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;That's it! No complex configuration, no elaborate plugin chains.&lt;/p&gt;
&lt;p&gt;Oh, which model? Right now I am using Claude 3.7 - it's so good.&lt;/p&gt;
&lt;h2 id=&quot;where-this-is-going&quot;&gt;Where This Is Going&lt;/h2&gt;
&lt;p&gt;You know that saying about technology and magic? This is it. We're witnessing the early days of a transformation in how software gets built. The tools are evolving to understand not just the syntax of our code, but the intent behind it.&lt;/p&gt;
&lt;p&gt;Could I have written a complex bash script to do some of this refactoring? Maybe.
Could I have used search-and-replace with regex? Probably.
Would either approach have understood the semantic meaning of my code well enough to know which strings need translation? Absolutely not.&lt;/p&gt;
&lt;h2 id=&quot;summary&quot;&gt;Summary&lt;/h2&gt;
&lt;p&gt;Vibe coding isn't just some feel-good developer term. It's that perfect state where you and your tools are in sync, where expressing your intent feels natural and immediate. With GitHub Copilot and VS Code, I'm experiencing this daily while building Nofidoc.&lt;/p&gt;
&lt;p&gt;If you're still doing manual refactoring in 2025, you're not just missing out on productivity-you're missing out on the pure joy of frictionless development.&lt;/p&gt;
&lt;p&gt;Try it. Feel it. Vibe code.&lt;/p&gt;
</content>
    </entry>
</feed>
