kitten-@-get-text(1)             kitten Manual            kitten-@-get-text(1)

<?><?><?> (NAME)
       kitten-@-get-text - <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       kitty

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       kitten @ get-text

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       --match, -m
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> field:query <?><?><?><?><?><?> <?><?> <?><?> <?><?>
              field <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?>: id<?> title<?> pid<?> cwd<?> cmdline<?>
              num<?> env<?> var<?> state<?> neighbor<?> session <?> recent.
              <?><?><?><?><?> query <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> (Regex) <?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?><?> all <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> id<?>
       pid<?> num <?> recent<?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> id <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> -1
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?> num <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?> <?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> kitten @ ls
       <?><?><?><?><?> <?><?><?><?><?><?><?>).

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> KITTY_WINDOW_ID <?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?><?> recent <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?><?> neighbor <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> left<?> right<?> top <?><?> bottom <?><?><?><?>.

       <?><?><?><?> session <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
       <?><?><?><?><?> ^$ <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> .  <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?>
       <?><?> ~ <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> (<?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>) <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> env
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>: env:MY_ENV_VAR=2.

       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> var <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?> env<?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?> <?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>.

       <?><?><?><?> state <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:
       active<?> focused<?> needs_attention<?> parent_active<?>
       parent_focused<?> focused_os_window<?> self <?> overlay_parent.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
       focused_os_window <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?> self <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?> overlay_parent
       <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> self
       <?><?><?><?> <?><?><?><?> (<?><?><?><?><?> <?><?> <?><?><?><?><?> self
       <?><?> <?><?><?><?> <?><?><?><?> <?><?> overlay <?><?><?>)
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> kitten @ ls
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       --extent [=screen]
              <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?><?> <?><?><?><?><?><?><?> screen <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?><?><?> all
              <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (scrollback)
              <?><?><?> <?> <?><?><?><?><?> selection <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?>
              first_cmd_output_on_screen <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?>. <?><?><?><?><?> last_cmd_output <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.
              <?><?><?><?><?> last_visited_cmd_output <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> scroll_to_prompt <?><?><?>. <?><?><?><?><?>
              last_non_empty_output <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>. <?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> shell_integration <?><?><?><?><?>. <?><?><?><?><?>
              alternate <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (<?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?>/<?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?>).
              <?><?><?><?><?> alternate_scrollback <?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> (<?><?> <?><?><?><?>
              <?><?><?><?>) <?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?><?><?> <?><?><?><?>: screen<?> all<?>
              alternate<?> alternate_scrollback<?>
              first_cmd_output_on_screen<?> last_cmd_output<?>
              last_non_empty_output<?> last_visited_cmd_output <?> selection

       --ansi [=no]
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?> <?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> ANSI <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> (bold)<?> <?><?><?><?>
              (italic) <?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       --add-cursor [=no]
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> ANSI
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>.

       --add-wrap-markers [=no]
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?> (carriage return) <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?> (<?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>).

       --clear-selection [=no]
              <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?>.

       --self [=no]
              <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?>.

       --help, -h [=no]
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (GLOBAL OPTIONS)
       --to   <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> kitty <?><?><?><?>
              <?><?><?> <?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> --listen-on <?><?> <?><?><?><?><?> listen_on
              <?><?> <?><?><?><?> kitty.conf <?><?> <?><?><?><?><?> kitty
              <?><?><?><?> <?><?><?> <?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              KITTY_LISTEN_ON <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?> kitty <?><?><?><?> <?><?><?>.

       --password
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> kitty. <?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> kitty <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?> <?><?> <?><?><?><?> kitty.conf <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> --use-password <?><?>
              <?><?><?><?><?> <?><?> always <?><?><?><?> <?><?><?><?>.

       --password-file [=rc-pass]
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> kitty
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> (STDIN) <?><?> -
              <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              num <?><?> fd:num <?><?><?><?><?><?><?> <?><?><?><?>. <?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              --password <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> rc-pass <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> kitty
              <?><?><?><?><?> <?><?><?><?><?><?>.

       --password-env [=KITTY_RC_PASSWORD]
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?> --password-file
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              KITTY_RC_PASSWORD <?><?><?><?><?> <?><?><?><?><?><?>.

       --use-password [=if-available]
              <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> kitty <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?> always
              <?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?><?><?> <?><?><?><?>: if-available<?> always
              <?> never

0.48.2                           July 30, 2026            kitten-@-get-text(1)