{"record":{"id":"3471c9b2cc6fd181","repo":"kovidgoyal/kitty","slug":"this-should-be-run-as-kitten-clipboard","errorCode":null,"errorMessage":"This should be run as kitten clipboard","messagePattern":"This should be run as kitten clipboard","errorType":"console","errorClass":"SystemExit","httpStatus":null,"severity":"info","filePath":"kittens/clipboard/main.py","lineNumber":95,"sourceCode":"    # Copy an image and some text to the clipboard:\n    kitten clipboard picture.jpg text.txt\n\n    # Copy text from STDIN and an image to the clipboard:\n    echo hello | kitten clipboard picture.png /dev/stdin\n\n    # Copy any raster image available on the clipboard to a PNG file:\n    kitten clipboard -g picture.png\n\n    # Copy an image to a file and text to STDOUT:\n    kitten clipboard -g picture.png /dev/stdout\n\n    # List the formats available on the system clipboard\n    kitten clipboard -g -m . /dev/stdout\n\"\"\"\n\nusage = '[files to copy to/from]'\nif __name__ == '__main__':\n    raise SystemExit('This should be run as kitten clipboard')\nelif __name__ == '__doc__':\n    from kitty.simple_cli_definitions import CompletionSpec\n\n    cd = sys.cli_docs  # type: ignore\n    cd['usage'] = usage\n    cd['options'] = OPTIONS\n    cd['help_text'] = help_text\n    cd['short_desc'] = 'Copy/paste with the system clipboard, even over SSH'\n    cd['args_completion'] = CompletionSpec.from_string('type:file mime:* group:Files')\n","sourceCodeStart":77,"sourceCodeEnd":105,"githubUrl":"https://github.com/kovidgoyal/kitty/blob/6d5d0c440603ad9bdf6dcd599f73f6dde21acb44/kittens/clipboard/main.py#L77-L105","documentation":"kitty's VT parser encountered an escape sequence it does not implement and reports it via _report_unknown_escape_code (kitty/vt-parser.c). By default it goes to the error log; with a dump callback (remote control / debug kitten) it is forwarded to Python instead. Only the first 64 bytes of the sequence are shown, with a category name (CSI/DCS/OSC/etc.).","triggerScenarios":"A program running in kitty emits an uncommon or private-mode escape sequence kitty hasn't implemented - e.g. proprietary terminal queries (some editors, tmux, IDE integrations, OSC 1337 iTerm2 extensions) or novel CSI sequences. Common during shell prompt integrations or capability probing.","commonSituations":"Newer shell frameworks (starship, oh-my-posh, zsh4humans) emitting shell-integration sequences, apps probing for kitty/iterm capabilities, or a garbled binary output (cat of a binary file) producing pseudo-escape sequences.","solutions":["Identify the emitting program by running apps one at a time or using kitty's debug input (ctrl+shift+f7 / kitten show-key).","Update kitty - newer versions implement more escape codes (shell integration, etc.).","Report the unimplemented sequence to kitty's GitHub if it's a standardized one.","Silence by not caring - it's informational and harmless; output is unaffected."],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":["Update kitty before filing issues - escape code coverage grows each release.","Use kitty's debug features (ctrl+shift+f7) to identify which app emits the sequence.","Ignore safely: unknown sequences never affect rendering."],"tags":["kitty","vt-parser","escape-code","terminal-emulation"],"backgroundTag":"unsupported-escape-sequence","analyzedSha":"6d5d0c440603ad9bdf6dcd599f73f6dde21acb44","analyzedAt":"2026-08-27T14:20:20.142Z","schemaVersion":2},"datasetVersion":"2026-08-27T19:17:21.184Z"}