kovidgoyal/kitty · error · SystemExit

This should be run as kitten hyperlinked_grep

Error message

This should be run as kitten hyperlinked_grep

What it means

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.

Source

Thrown at kittens/hyperlinked_grep/main.py:7

#!/usr/bin/env python
# License: GPLv3 Copyright: 2020, Kovid Goyal <kovid at kovidgoyal.net>

import sys

if __name__ == '__main__':
    raise SystemExit('This should be run as kitten hyperlinked_grep')
elif __name__ == '__wrapper_of__':
    cd = sys.cli_docs  # type: ignore
    cd['wrapper_of'] = 'rg'

View on GitHub (pinned to 6d5d0c4406)

Solutions

1. Read the stack frames to find the topmost kitty function and report it with the exception message to kitty's GitHub.
2. Update kitty to the latest release for current macOS fixes.
3. Reproduce reliably and include macOS version + stack in the issue.

# preserve stack traces for bug reports
kitty 2> >(tee ~/kitty-cocoa.log) ; grep -A30 'Stack trace' ~/kitty-cocoa.log

When it happens

Trigger: Same trigger as the preceding uncaught-exception log - any NSException escaping Cocoa code in kitty on macOS; this line carries the symbolicated stack frames.

Common situations: Triaging macOS-specific kitty crashes; the stack shows whether the fault is in AppKit, kitty's cocoa_window.m, or a GPU callback.

Related errors

• This must be run as kitten desktop-ui
• Should be run as kitten hints
• Must be run as kitten diff
• This should be run as kitten dnd
• The value {val} is not a valid choice for window_title_bar

AI-assisted analysis of kovidgoyal/kitty@6d5d0c4406 (2026-08-27). Data as JSON: /api/errors/af2acb375f932fec. Report an issue: GitHub.