ghostty

Ghostty codebase coding patterns for Zig (core, C API, termio) and Swift (macOS app). Load when reading or writing Zig or Swift files in this repo. Covers naming, error handling, logging, config, memory, imports, tests, C interop, and state restoration conventions.

Triage Ghostty macOS crashes by extracting .ghosttycrash envelopes, matching minidumps to dSYM debug IDs, symbolicating with lldb/atos, and writing a dated bug+crash report archive entry. Use when debugging Ghostty renderer crashes, OSC8 hover issues, or any panic/index-out-of-bounds reports captured in ~/.local/state/ghostty/crash.

Investigate and debug Ghostty scrollback snapshot persistence issues. Use when scrollback restore fails after app restart, upgrade, or rebase+rebuild. Use when investigating missing manifests, FileNotFound errors, UUID mismatches, or cleanup race conditions. Also use to take pre/post restart inventory of snapshots for QA validation.