kitty

$ kitty --version
kitty 0.48.2 created by Kovid Goyal

$ kitten @ --help
Usage: kitten @ [global options] [sub-command] [sub-command options] [sub-command args]

Control kitty by sending it commands. Set the allow_remote_control option in
kitty.conf for this to work. When run without any sub-commands this will start
an interactive shell to control kitty.

Commands:
   action
    Run the specified mappable action
   close-tab
    Close the specified tabs
   close-window
    Close the specified windows
   create-marker
    Create a marker that highlights specified text
   detach-tab
    Detach the specified tabs and place them in a different/new OS window
   detach-window
    Detach the specified windows and place them in a different/new tab
   disable-ligatures
    Control ligature rendering
   env
    Change environment variables seen by future children
   focus-tab
    Focus the specified tab
   focus-window
    Focus the specified window
   get-colors
    Get terminal colors
   get-text
    Get text from the specified window
   goto-layout
    Set the window layout
   kitten
    Run a kitten
   last-used-layout
    Switch to the last used layout
   launch
    Run an arbitrary process in a new window/tab
   load-config
    (Re)load a config file
   ls
    List tabs/windows
   new-window
    Open new window
   remove-marker
    Remove the currently set marker, if any.
   resize-os-window
    Resize/show/hide/etc. the specified OS Windows
   resize-window
    Resize the specified windows
   run
    Run a program on the computer in which kitty is running and get the output
   scroll-window
    Scroll the specified windows
   select-window
    Visually select a window in the specified tab
   send-[redacted]
    Send arbitrary [redacted] presses to the specified windows
   send-text
    Send arbitrary text to specified windows
   set-background-image
    Set the background image
   set-background-opacity
    Set the background opacity
   set-colors
    Set terminal colors
   set-enabled-layouts
    Set the enabled layouts in tabs
   set-font-size
    Set the font size in the active top-level OS window
   set-spacing
    Set window paddings and margins
   set-tab-color
    Change the color of the specified tabs in the tab bar
   set-tab-title
    Set the tab title
   set-user-vars
    Set user variables on a window
   set-window-logo
    Set the window logo
   set-window-title
    Set the window title
   signal-child
    Send a signal to the foreground process in the specified windows

Get help for an individual command by running:
    kitten @ command -h

Global options:
  --to
    An address for the kitty instance to control. Corresponds to the address
    given to the kitty instance via the --listen-on option or the listen_on
    setting in kitty.conf. If not specified, the environment variable
    KITTY_LISTEN_ON is checked. If that is also not found, messages are sent to
    the controlling terminal for this process, i.e. they will only work if this
    process is run within a kitty window.

  --password
    A password to use when contacting kitty. This will cause kitty to ask the
    user for permission to perform the specified action, unless the password has
    been accepted before or is pre-configured in kitty.conf. To use a blank
    password specify --use-password as always.

  --password-file [=rc-pass]
    A file from which to read the password. Trailing whitespace is ignored.
    Relative paths are resolved from the kitty configuration directory. Use - to
    read from STDIN. Use fd:num to read from the file descriptor num. Used if no
    --password is supplied. Defaults to checking for the rc-pass file in the
    kitty configuration directory.

  --password-env [=KITTY_RC_PASSWORD]
    The name of an environment variable to read the password from. Used if no
    --password-file is supplied. Defaults to checking the environment variable
    KITTY_RC_PASSWORD.

  --use-password [=if-available]
    If no password is available, kitty will usually just send the remote control
    command without a password. This option can be used to force it to always or
    never use the supplied password. If set to always and no password is
    provided, the blank password is used.
    Choices: if-available, always, never

Options:
  --help, -h [=no]
    Show help for this command

kitten @ 0.48.2 created by Kovid Goyal

$ kitty --detach -o allow_remote_control=socket-only --listen-on unix:/tmp/pa-kitty-probe && kitten @ --to unix:/tmp/pa-kitty-probe ls && kitten @ ... send-text "echo PA_PROBE_OK\n" && kitten @ ... get-text && kitten @ ... close-window --match all
[
  {
    "active_tab_history": [],
    "background_opacity": 1.0,
    "id": 1,
    "is_active": true,
    "is_focused": false,
    "last_focused": true,
    "platform_window_id": 45448,
    "tabs": [
      {
        "active_window_history": [
          1
        ],
        "enabled_layouts": [
          "fat",
          "grid",
          "horizontal",
          "splits",
          "stack",
          "tall",
          "vertical"
        ],
        "groups": [
          {
            "id": 1,
            "windows": [
              1
            ]
          }
        ],
        "id": 1,
        "is_active": true,
        "is_focused": false,
        "layout": "fat",
        "layout_opts": {
          "bias": 50,
          "full_size": 1,
          "mirrored": "n"
        },
        "layout_state": {
          "all_windows": {
            "active_group_history": [
              1
            ],
            "active_group_idx": 0,
            "window_groups": [
              {
                "id": 1,
                "window_ids": [
                  1
                ]
              }
            ]
          },
          "biased_map": {},
          "class": "Fat",
          "main_bias": [
            0.5,
            0.5
          ],
          "opts": {
            "bias": 50,
            "full_size": 1,
            "mirrored": "n"
          }
        },
        "title": "\u2026/.claude/worktrees/agent-a1cb212b2713e2797",
        "title_overridden": false,
        "windows": [
          {
            "at_prompt": true,
            "cmdline": [
              "/bin/zsh"
            ],
            "columns": 91,
            "created_at": 1788549744199424000,
            "cwd": "/Users/judegomila/Documents/GitHub/productarena/.claude/worktrees/agent-a1cb212b2713e2797",
            "env": {
              "COLORTERM": "truecolor",
              "HOME": "/Users/judegomila",
              "KITTY_INSTALLATION_DIR": "/Applications/kitty.app/Contents/Resources/kitty",
              "KITTY_LISTEN_ON": "unix:/tmp/pa-kitty-probe",
              "KITTY_PID": "68129",
              "KITTY_PUBLIC_[redacted]": "1:1c1y3P|8V&e3q{yBJP2zk=sDVGstwKB(hV#UjwE*",
              "KITTY_WINDOW_ID": "1",
              "LANG": "en_US.UTF-8",
              "MANPATH": "/Applications/kitty.app/Contents/Resources/man:",
              "NODE_ENV": "production",
              "PATH": "/Applications/kitty.app/Contents/MacOS:/Users/judegomila/Documents/GitHub/productarena/.claude/worktrees/agent-a1cb212b2713e2797/node_modules/.bin:/opt/homebrew/lib/node_modules/pnpm/dist/node-gyp-bin:/Users/judegomila/Documents/GitHub/productarena/.claude/worktrees/agent-a1cb212b2713e2797/node_modules/.bin:/Users/judegomila/.opencode/bin:/Users/judegomila/.local/bin:/Users/judegomila/.local/bin:/Users/judegomila/.elan/bin:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/pkg/env/global/bin:/Library/TeX/texbin:/Users/judegomila/.cargo/bin:/Applications/Ghostty.app/Contents/MacOS:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/frontend-design/unknown/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/code-review/unknown/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/code-simplifier/1.0.0/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/superpowers/6.3.0/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/feature-dev/unknown/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/math-olympiad/unknown/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/hookify/unknown/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/skill-creator/unknown/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/session-report/unknown/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/claude-md-management/1.0.0/bin:/Users/judegomila/.claude/plugins/cache/claude-plugins-official/swift-lsp/1.0.0/bin",
              "PWD": "/Users/judegomila/Documents/GitHub/productarena/.claude/worktrees/agent-a1cb212b2713e2797",
              "SCRIPT": "/var/folders/y3/9hs_txjs2ng3w8q679fywqyh0000gn/T/pa-probe-record-xfOafl/kitty-remote-control-roundtrip.raw",
              "SHLVL": "1",
              "TERM": "xterm-kitty",
              "TERMINFO": "/Applications/kitty.app/Contents/Resources/kitty/terminfo",
              "WINDOWID": "45448",
              "_": "/opt/homebrew/bin/kitty",
              "__CF_USER_TEXT_ENCODING": "0x1F5:0x0:0x0"
            },
            "foreground_processes": [
              {
                "cmdline": [
                  "-zsh"
                ],
                "cwd": "/Users/judegomila/Documents/GitHub/productarena/.claude/worktrees/agent-a1cb212b2713e2797",
                "pid": 68137
              }
            ],
            "has_activity_since_last_focus": false,
            "id": 1,
            "in_alternate_screen": false,
            "is_active": true,
            "is_focused": false,
            "is_self": false,
            "last_cmd_exit_status": 0,
            "last_focused_at": 0.561231,
            "last_reported_cmdline": "",
            "lines": 30,
            "needs_attention": false,
            "neighbors": {
              "bottom": []
            },
            "pid": 68133,
            "session_name": "",
            "title": "\u2026/.claude/worktrees/agent-a1cb212b2713e2797",
            "title_overridden": false,
            "user_vars": {}
          }
        ]
      }
    ],
    "wm_class": "kitty",
    "wm_name": "kitty"
  }
]
Last login: Fri Sep  4 12:21:21 on ttys054
judegomila@Judes-MBP agent-a1cb212b2713e2797 % echo PA_PROBE_OK
PA_PROBE_OK
judegomila@Judes-MBP agent-a1cb212b2713e2797 %