ghostty-crash

Parse .ghosttycrash files to extract JSON metadata and MDMP minidumps.

13|Updated May 19, 2024
One-click install
npx skills add https://github.com/david-crespo/dotfiles --skill ghostty-crash
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ghostty-crash
Source: https://github.com/david-crespo/dotfiles/tree/main/claude/skills/ghostty-crash
Command: npx skills add https://github.com/david-crespo/dotfiles --skill ghostty-crash

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ghostty crash debugging is streamlined by providing a clear workflow to extract and inspect crash data from ghostty crash dumps, enabling faster root-cause analysis.

Core Features & Use Cases

  • Crash data extraction: locate and parse the .ghosttycrash file to separate JSON header and minidump.
  • Metadata analysis: inspect the Sentry-like event data to understand build, OS, and session duration.
  • Minidump investigation: extract the minidump and run symbolication tools to map addresses to code.
  • Investigation workflow: produce a reproducible report detailing findings and suggested fixes.

Quick Start

Run the ghostty crash analysis workflow by locating a .ghosttycrash file, extract the JSON header before the MDMP marker, then analyze the minidump with minidump-stackwalk and symbolicate addresses to reproduce the crash.

Frequently Asked Questions about ghostty-crash

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a Ghostty crash dump from a .ghosttycrash file?

To analyze a Ghostty crash dump, you parse the .ghosttycrash file to separate the Sentry-like JSON header from the MDMP minidump segment, extracting metadata to understand the build and OS context before running symbolication.

How does minidump symbolication work for Ghostty crashes?

Minidump symbolication for Ghostty crashes works by locating the MDMP segment within the crash file and using tools like minidump-stackwalk to map raw memory addresses back to specific lines of code for root-cause analysis.

Can I use this crash analysis workflow on both macOS and Linux?

Yes, this crash analysis workflow is explicitly designed for developers diagnosing Ghostty crashes on both macOS and Linux, handling multi-part crash files and extracting session metadata uniformly across these operating systems.

What is the structure of a Ghostty crash report file?

A Ghostty crash report file is a multi-part document containing a Sentry-like JSON header with build, OS, and session duration metadata, followed immediately by a binary MDMP minidump marker containing the actual crash memory data.

How do I generate a reproducible report from a Ghostty crash?

To generate a reproducible report from a Ghostty crash, follow the structured investigation workflow to extract JSON metadata, symbolicate minidump addresses, and document findings detailing the crash context and suggested fixes.