{"record":{"id":"af2acb375f932fec","repo":"kovidgoyal/kitty","slug":"this-should-be-run-as-kitten-hyperlinked-grep","errorCode":null,"errorMessage":"This should be run as kitten hyperlinked_grep","messagePattern":"This should be run as kitten hyperlinked_grep","errorType":"console","errorClass":"SystemExit","httpStatus":null,"severity":"error","filePath":"kittens/hyperlinked_grep/main.py","lineNumber":7,"sourceCode":"#!/usr/bin/env python\n# License: GPLv3 Copyright: 2020, Kovid Goyal <kovid at kovidgoyal.net>\n\nimport sys\n\nif __name__ == '__main__':\n    raise SystemExit('This should be run as kitten hyperlinked_grep')\nelif __name__ == '__wrapper_of__':\n    cd = sys.cli_docs  # type: ignore\n    cd['wrapper_of'] = 'rg'\n","sourceCodeStart":1,"sourceCodeEnd":11,"githubUrl":"https://github.com/kovidgoyal/kitty/blob/6d5d0c440603ad9bdf6dcd599f73f6dde21acb44/kittens/hyperlinked_grep/main.py#L1-L11","documentation":"Companion log to the previous error: kitty's uncaughtExceptionHandler prints the NSException's callStackSymbols (kitty/cocoa_window.m:1204). It is diagnostic output, not a separate failure; it appears only after 'Unhandled exception in Cocoa' and provides the native stack for the exception.","triggerScenarios":"Same trigger as the preceding uncaught-exception log - any NSException escaping Cocoa code in kitty on macOS; this line carries the symbolicated stack frames.","commonSituations":"Triaging macOS-specific kitty crashes; the stack shows whether the fault is in AppKit, kitty's cocoa_window.m, or a GPU callback.","solutions":["Read the stack frames to find the topmost kitty function and report it with the exception message to kitty's GitHub.","Update kitty to the latest release for current macOS fixes.","Reproduce reliably and include macOS version + stack in the issue."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"# preserve stack traces for bug reports\nkitty 2> >(tee ~/kitty-cocoa.log) ; grep -A30 'Stack trace' ~/kitty-cocoa.log","preventionTips":["Always collect the stack trace together with the exception message.","Include macOS and kitty versions when reporting.","Isolate triggers (fullscreen/resize/tab ops) to narrow the cause."],"tags":["kitty","macos","cocoa","stack-trace","diagnostics"],"backgroundTag":"uncaught-native-exception","analyzedSha":"6d5d0c440603ad9bdf6dcd599f73f6dde21acb44","analyzedAt":"2026-08-27T14:20:20.142Z","schemaVersion":2},"datasetVersion":"2026-08-27T19:17:21.184Z"}