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.