Windows Claude Code Doctor

    2

    Diagnose and fix Windows-specific AI coding agent failures across shells, paths, WSL, locks, ports, and CRLF diffs.

    $5

    30-day refund guarantee

    Secure checkout via Stripe

    0 installsSecurity scanned

    Works with the AI tools you already use

    CClaude CodeCCursorCCodex CLIGGitHub CopilotGGemini CLI+17 more

    See it in action

    You say

    My AI coding agent is running on Windows PowerShell and keeps failing commands like rm -rf node_modules && npm install. It also says port 3000 is already in use. Diagnose the environment and give me the safest fix.

    Your agent does

    Environment: Windows-native PowerShell Failure class: Linux command leakage + port conflict

    Evidence:

    • diagnose-shell.ps1 detected PowerShell, not Bash.
    • The command uses Bash-style rm -rf and shell chaining assumptions.
    • find-port-holder.ps1 -Port 3000 identified the owning PID and process name.

    Fix:

    • Replace rm -rf node_modules with: Remove-Item -LiteralPath .\node_modules -Recurse -Force
    • Run npm install only after the delete succeeds.
    • Stop the identified dev server process gracefully before restarting.

    Verification:

    • Re-run find-port-holder.ps1 -Port 3000.
    • Re-run the install through: invoke-native.ps1 -- npm install

    What you get

    Fix Linux command leakage in PowerShell or cmd.exe sessions.Translate paths between WSL and native Windows to fix broken tool calls.Resolve database and file locks (EADDRINUSE/EBUSY) on Windows.Normalize line endings to prevent CRLF pollution in git diffs.Capture correct exit codes from native Windows commands in terminal agents.

    About this skill

    Windows Claude Code Doctor helps AI coding agents recover from the Windows-specific failures that break real development loops: Bash commands leaking into PowerShell, broken Windows/WSL/Git Bash path translation, WSL vs native runtime confusion, lost PowerShell exit codes, CRLF diff explosions, SQLite lock loops, busy ports, and EBUSY/EPERM file locks.

    It is built for Claude Code, Codex CLI, Cursor, OpenClaw, VS Code agents, Gemini CLI, and other SKILL.md-compatible coding agents. The skill gives agents a practical triage workflow, seven focused troubleshooting playbooks, reusable PowerShell diagnostics, and reference notes for the most common Windows agent failure modes.

    Buy this if you run AI coding agents on Windows or WSL and want them to stop guessing, stop retrying broken Linux commands, and produce evidence-backed fixes with clear verification steps.

    How to install

    Drop the file into your AI Agent. Works with Claude, Cursor, ChatGPT, and 20+ more.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    30-day refund

    Not a fit? Get your money back

    Trust & safety

    Security scanned

    Verified clean 3 months ago

    Listed3 months ago

    Frequently Asked Questions