# crashlens

> A crash-triage tool that turns Linux core dumps, runtime panics, exception traces and sanitizer reports into Markdown bug reports naming the crash type, the first frame in the user’s code and a stable signature. Its core-dump path calls the REA CLI to read the recorded crash and the binary layout, and can ask REA’s Ghidra provider for pseudocode of stripped functions; a Claude Code plugin bundles a skill and read-only MCP tools. It is a debugging integration around REA, not a reconstruction case, and its diagnostic accuracy remains author-reported.

- Type: Integration
- Targets: Binary
- Category: Community REA integrations
- Relationship: Community REA integration
- Sources reviewed: 2026-10-18
- Added to the catalog: 2026-10-19
- Original resource: <https://github.com/mingleiw/crashlens>
- Primary source: <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/README.md>
- Catalog page: <https://awesomerea.org/resources/crashlens-rea-crash-triage/>
- Record JSON: <https://awesomerea.org/resources/crashlens-rea-crash-triage/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/crashlens-rea-crash-triage/index.md)

## Requirements & limits

- Package 0.1.0 and plugin 0.2.0 are an early prototype. Panic, trace and ASan/LSan/UBSan text inputs need only Node.js 22.19+ or 24.11+. Core dumps need Linux x86-64, Python 3, rea-agents and a pwntools environment named by REA_PWNTOOLS_PYTHON; gdb, objdump and Ghidra 12.1.x with JDK 21 are optional. Windows minidumps and macOS crash reports remain roadmap items.
- Supply the core dump and the exact binary that crashed; crashlens compares GNU build IDs and warns on a mismatch. rea-agents 6.4.0 or later is an optional peer dependency, and the author describes only a pinned 6.4.0 as compatible.
- The plugin’s MCP server defines four read-only tools, analyze_failure, analyze_core_dump, decompile_function and analyze_crash_folder. Pseudocode is decompiler output, and crash types are heuristics with a stated confidence.
- The analyzed program is not executed; gdb runs with script auto-loading and debuginfod disabled. The optional --ai flag sends the report, including code snippets and log lines, to the Anthropic API; the local web app binds 127.0.0.1 behind a session token. Core dumps can hold secrets, and reports include local paths and register values.
- CI runs typechecks and unit tests on Node 22 and 24 plus an end-to-end NULL-dereference check with the latest rea-agents; the six-of-seven root-cause claim has no published transcripts.
- MIT, using MIT-licensed REA through its public CLI; Ghidra, the Anthropic API and analyzed programs keep their own terms.

## Primary sources

1. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/README.md>
2. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/plugin/skills/crashlens/SKILL.md>
3. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/docs/prompts/crash-triage.md>
4. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/src/rea.ts>
5. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/src/mcp.ts>
6. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/package.json>
7. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/plugin/.claude-plugin/plugin.json>
8. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/.github/workflows/ci.yml>
9. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/test/e2e.test.ts>
10. <https://github.com/mingleiw/crashlens/blob/7188611a506e058a8f4937acf3dfd3035545f2d1/LICENSE>
11. <https://x.com/rae1101x/status/2111052456151154858>

## More in Agents and MCP

- [REA Workspace Template](https://awesomerea.org/resources/rea-workspace-template/index.md) · Integration
- [REA Reconstruction Companion](https://awesomerea.org/resources/rea-reconstruction-companion/index.md) · Integration
- [App X-Ray](https://awesomerea.org/resources/app-xray-rea-evidence-reports/index.md) · Integration
- [Hex-Rays IDA MCP](https://awesomerea.org/resources/hex-rays-ida-mcp/index.md) · Integration
- [GhidraMCP](https://awesomerea.org/resources/ghidramcp/index.md) · Integration
- [Binary Ninja MCP (official)](https://awesomerea.org/resources/binary-ninja-official-mcp/index.md) · Integration

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.