# Cursor Doctor

> Cursor IDE diagnostic, pricing, and repair CLI. 28 error signatures across 10 categories, auto-fix, pricing matrix with 4 plan comparisons, and migration guide. Built from 156 V2EX + 85 CSDN real pain signals.

- Skill: `minirr890112-byte/cursor-doctor` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add minirr890112-byte/cursor-doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/minirr890112-byte/cursor-doctor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: minirr890112-byte (https://skillmd.com/u/minirr890112-byte)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/minirr890112-byte/cursor-doctor

---


# Cursor Doctor

## Problem → Solution

**The problem**: Cursor crashes. "MCP Client Closed." "Applying edit failed." You search GitHub issues, V2EX threads, CSDN posts — 45 minutes later you're no closer to a fix. Meanwhile, Cursor just dropped a new pricing tier and you don't know if you're overpaying.

**The solution**: One command diagnoses your Cursor environment against 28 known error signatures sourced from 156 V2EX + 85 CSDN discussions. Auto-fix for common issues. Pricing matrix compares all 4 Cursor plans. Migration guide for the 500-limit changes.

## Quick Start

```bash
pip install git+https://github.com/minirr890112-byte/cursor-doctor.git

cursor-doctor diagnose       # Full health check
cursor-doctor fix            # Auto-fix common issues
cursor-doctor pricing        # Plan comparison matrix
cursor-doctor migrate        # 500-limit → unlimited guide
cursor-doctor signatures     # Browse 28 error signatures
```

## Real Output

```
$ cursor-doctor diagnose

🩺 Cursor Doctor v1.2.0 — Diagnostic Report
────────────────────────────────────────────
✅ Cursor Version: 0.48.3 (latest)
✅ System: macOS 15.3, Python 3.12
⚠️  MCP Connection: 2 recent disconnects
❌ Extension Crash: 1 crash in last 24h
────────────────────────────────────────────
Health Score: 72/100 ⚠️
Recommendation: Run 'cursor-doctor fix mcp_connection'
```

## 10 Error Categories (28 signatures)

| Category | Count | Top Signature |
|----------|-------|---------------|
| MCP Connection | 5 | "MCP Client Closed" |
| Crash/Freeze | 4 | "Window not responding" |
| Network/Proxy | 3 | "Failed to fetch" |
| Config/Env | 3 | "Extension host terminated" |
| Pricing/Billing | 4 | "Usage limit reached" |
| Performance | 3 | "High memory usage" |
| Update | 2 | "Update failed" |
| Account | 2 | "Login expired" |
| Edit/Apply | 1 | "Apply edit failed" |
| Composer | 1 | "Composer unavailable" |

---
⭐ **Star this repo if it fixed your Cursor**: [github.com/minirr890112-byte/cursor-doctor](https://github.com/minirr890112-byte/cursor-doctor)