# crashdx

Reads Apple .ips crash reports, uses dSYMs for symbolication, and ranks likely causes with evidence you can trace back to the report.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 7
- Author: r00tify
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/r00tify/crashdx
- Updated: 2026-07-27
- HTML: https://affpapa.org/en/nevibecode/mcp/crashdx

## What it does

crashdx processes Apple `.ips` reports and extracts signals from watchdog data, jetsam records, register and memory state, exceptions, and `lastExceptionBacktrace`. It compares possible causes instead of stopping at a symbolicated stack trace. Each supporting fact points to a location in the original JSON report.

The project includes the Swift library `CrashDXCore`, the `crashdx` CLI, and the `crashdx-mcp` server, all backed by the same engine. The engine makes no LLM calls; it returns facts, ranked interpretations, and follow-up checks. When the leading explanation is not clearly supported, the result stays inconclusive and lists the competing candidates. App frames remain only partly symbolicated without dSYMs.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- parse an Apple `.ips` crash report
- symbolicate app frames with a dSYM
- rank competing crash hypotheses
- trace evidence back to the raw report
- separate a strong diagnosis from an inconclusive result

## Example prompts
- Analyze `crash.ips` and explain the most likely cause.
- Use `crash.ips` with `MyApp.dSYM` and cite the facts supporting the diagnosis.
- List the competing hypotheses for this report and what would distinguish them.

## Similar
- [sentry-snapshots-cocoa](https://affpapa.org/en/nevibecode/skills/sentry-snapshots-cocoa.md) — skill · 577 installs
- [natural-language](https://affpapa.org/en/nevibecode/skills/natural-language.md) — skill · 3700 installs
- [relevancekit](https://affpapa.org/en/nevibecode/skills/relevancekit.md) — skill · 3000 installs
- [sosumi](https://affpapa.org/en/nevibecode/skills/sosumi.md) — skill · 2000 installs
- [axiom-apple-docs](https://affpapa.org/en/nevibecode/skills/axiom-apple-docs.md) — skill · 1500 installs
- [swiftui-skills](https://affpapa.org/en/nevibecode/skills/swiftui-skills.md) — skill · 756 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md