diff --git a/src/shell-integration/zsh/.zshenv b/src/shell-integration/zsh/.zshenv
new file mode 100644
index 000000000..4f98b1c39
--- /dev/null
+++ b/src/shell-integration/zsh/.zshenv
@@ -0,0 +1,62 @@
+# Based on (started as) a copy of Kitty's zsh integration. Kitty is
+# distributed under GPLv3, so this file is also distributed under GPLv3.
+# The license header is reproduced below:
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see .
+
+# This file can get sourced with aliases enabled. To avoid alias expansion
+# we quote everything that can be quoted. Some aliases will still break us
+# though.
+
+# Don't use [[ -v ... ]] because it doesn't work in zsh < 5.4.
+if [[ -n "${GHOSTTY_ORIG_ZDOTDIR+X}" ]]; then
+ # Normally ZDOTDIR shouldn't be exported but it was in the environment
+ # of Ghostty, so we export it.
+ 'builtin' 'export' ZDOTDIR="$GHOSTTY_ORIG_ZDOTDIR"
+ 'builtin' 'unset' 'GHOSTTY_ORIG_ZDOTDIR'
+else
+ 'builtin' 'unset' 'ZDOTDIR'
+fi
+
+# Use try-always to have the right error code.
+{
+ # Zsh treats empty $ZDOTDIR as if it was "/". We do the same.
+ #
+ # Source the user's zshenv before sourcing ghostty.zsh because the former
+ # might set fpath and other things without which ghostty.zsh won't work.
+ #
+ # Use typeset in case we are in a function with warn_create_global in
+ # effect. Unlikely but better safe than sorry.
+ 'builtin' 'typeset' _ghostty_file=${ZDOTDIR-~}"/.zshenv"
+ # Zsh ignores unreadable rc files. We do the same.
+ # Zsh ignores rc files that are directories, and so does source.
+ [[ ! -r "$_ghostty_file" ]] || 'builtin' 'source' '--' "$_ghostty_file"
+} always {
+ if [[ -o 'interactive' ]]; then
+ 'builtin' 'autoload' '--' 'is-at-least'
+ 'is-at-least' "5.1" || {
+ builtin echo "ZSH ${ZSH_VERSION} is too old for ghostty shell integration" > /dev/stderr
+ return
+ }
+ # ${(%):-%x} is the path to the current file.
+ # On top of it we add :A:h to get the directory.
+ 'builtin' 'typeset' _ghostty_file="${${(%):-%x}:A:h}"/ghostty-integration
+ if [[ -r "$_ghostty_file" ]]; then
+ 'builtin' 'autoload' '-Uz' '--' "$_ghostty_file"
+ "${_ghostty_file:t}"
+ 'builtin' 'unfunction' '--' "${_ghostty_file:t}"
+ fi
+ fi
+ 'builtin' 'unset' '_ghostty_file'
+}
diff --git a/src/shell-integration/zsh/ghostty-integration b/src/shell-integration/zsh/ghostty-integration
new file mode 100755
index 000000000..32cddaeb8
--- /dev/null
+++ b/src/shell-integration/zsh/ghostty-integration
@@ -0,0 +1,280 @@
+#!/bin/zsh
+#
+# Based on (started as) a copy of Kitty's zsh integration. Kitty is
+# distributed under GPLv3, so this file is also distributed under GPLv3.
+# The license header is reproduced below:
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see .
+
+#
+# Enables integration between zsh and ghostty.
+#
+# This is an autoloadable function. It's invoked automatically in shells
+# directly spawned by Ghostty but not in any other shells. For example, running
+# `exec zsh`, `sudo -E zsh`, `tmux`, or plain `zsh` will create a shell where
+# ghostty-integration won't automatically run. Zsh users who want integration with
+# Ghostty in all shells should add the following lines to their .zshrc:
+#
+# if [[ -n $GHOSTTY_RESOURCES_DIR ]]; then
+# autoload -Uz -- "$GHOSTTY_RESOURCSE_DIR"/shell-integration/zsh/ghostty-integration
+# ghostty-integration
+# unfunction ghostty-integration
+# fi
+#
+# Implementation note: We can assume that alias expansion is disabled in this
+# file, so no need to quote defensively. We still have to defensively prefix all
+# builtins with `builtin` to avoid accidentally invoking user-defined functions.
+# We avoid `function` reserved word as an additional defensive measure.
+
+builtin emulate -L zsh -o no_warn_create_global -o no_aliases
+
+[[ -o interactive ]] || builtin return 0 # non-interactive shell
+(( ! $+_ghostty_state )) || builtin return 0 # already initialized
+
+# 0: no OSC 133 [AC] marks have been written yet.
+# 1: the last written OSC 133 C has not been closed with D yet.
+# 2: none of the above.
+builtin typeset -gi _ghostty_state
+
+# Attempt to create a writable file descriptor to the TTY so that we can print
+# to the TTY later even when STDOUT is redirected. This code is fairly subtle.
+#
+# - It's tempting to do `[[ -t 1 ]] && exec {_ghostty_state}>&1` but we cannot do this
+# because it'll create a file descriptor >= 10 without O_CLOEXEC. This file
+# descriptor will leak to child processes.
+# - If we do `exec {3}>&1`, the file descriptor won't leak to the child processes
+# but it'll still leak if the current process is replaced with another. In
+# addition, it'll break user code that relies on fd 3 being available.
+# - Zsh doesn't expose dup3, which would have allowed us to copy STDOUT with
+# O_CLOEXEC. The only way to create a file descriptor with O_CLOEXEC is via
+# sysopen.
+# - `zmodload zsh/system` and `sysopen -o cloexec -wu _ghostty_fd -- /dev/tty` can
+# fail with an error message to STDERR (the latter can happen even if /dev/tty
+# is writable), hence the redirection of STDERR. We do it for the whole block
+# for performance reasons (redirections are slow).
+# - We must open the file descriptor right here rather than in _ghostty_deferred_init
+# because there are broken zsh plugins out there that run `exec {fd}< <(cmd)`
+# and then close the file descriptor more than once while suppressing errors.
+# This could end up closing our file descriptor if we opened it in
+# _ghostty_deferred_init.
+typeset -gi _ghostty_fd
+{
+ builtin zmodload zsh/system && (( $+builtins[sysopen] )) && {
+ { [[ -w $TTY ]] && builtin sysopen -o cloexec -wu _ghostty_fd -- $TTY } ||
+ { [[ -w /dev/tty ]] && builtin sysopen -o cloexec -wu _ghostty_fd -- /dev/tty }
+ }
+} 2>/dev/null || (( _ghostty_fd = 1 ))
+
+# Defer initialization so that other zsh init files can be configure
+# the integration.
+builtin typeset -ag precmd_functions
+precmd_functions+=(_ghostty_deferred_init)
+
+_ghostty_deferred_init() {
+ builtin emulate -L zsh -o no_warn_create_global -o no_aliases
+
+ # The directory where ghostty-integration is located: /../shell-integration/zsh.
+ builtin local self_dir="${functions_source[_ghostty_deferred_init]:A:h}"
+
+ # Enable semantic markup with OSC 133.
+ _ghostty_precmd() {
+ builtin local -i cmd_status=$?
+ builtin emulate -L zsh -o no_warn_create_global -o no_aliases
+
+ # Don't write OSC 133 D when our precmd handler is invoked from zle.
+ # Some plugins do that to update prompt on cd.
+ if ! builtin zle; then
+ # This code works incorrectly in the presence of a precmd or chpwd
+ # hook that prints. For example, sindresorhus/pure prints an empty
+ # line on precmd and marlonrichert/zsh-snap prints $PWD on chpwd.
+ # We'll end up writing our OSC 133 D mark too late.
+ #
+ # Another failure mode is when the output of a command doesn't end
+ # with LF and prompst_sp is set (it is by default). In this case
+ # we'll incorrectly state that '%' from prompt_sp is a part of the
+ # command's output.
+ if (( _ghostty_state == 1 )); then
+ # The last written OSC 133 C has not been closed with D yet.
+ # Close it and supply status.
+ builtin print -nu $_ghostty_fd '\e]133;D;'$cmd_status'\a'
+ (( _ghostty_state = 2 ))
+ elif (( _ghostty_state == 2 )); then
+ # There might be an unclosed OSC 133 C. Close that.
+ builtin print -nu $_ghostty_fd '\e]133;D\a'
+ fi
+ fi
+
+ builtin local mark1=$'%{\e]133;A\a%}'
+ if [[ -o prompt_percent ]]; then
+ builtin typeset -g precmd_functions
+ if [[ ${precmd_functions[-1]} == _ghostty_precmd ]]; then
+ # This is the best case for us: we can add our marks to PS1 and
+ # PS2. This way our marks will be printed whenever zsh
+ # redisplays prompt: on reset-prompt, on SIGWINCH, and on
+ # SIGCHLD if notify is set. Themes that update prompt
+ # asynchronously from a `zle -F` handler might still remove our
+ # marks. Oh well.
+ builtin local mark2=$'%{\e]133;A;k=s\a%}'
+ # Add marks conditionally to avoid a situation where we have
+ # several marks in place. These conditions can have false
+ # positives and false negatives though.
+ #
+ # - False positive (with prompt_percent): PS1="%(?.$mark1.)"
+ # - False negative (with prompt_subst): PS1='$mark1'
+ [[ $PS1 == *$mark1* ]] || PS1=${mark1}${PS1}
+ # PS2 mark is needed when clearing the prompt on resize
+ [[ $PS2 == *$mark2* ]] || PS2=${mark2}${PS2}
+ (( _ghostty_state = 2 ))
+ else
+ # If our precmd hook is not the last, we cannot rely on prompt
+ # changes to stick, so we don't even try. At least we can move
+ # our hook to the end to have better luck next time. If there is
+ # another piece of code that wants to take this privileged
+ # position, this won't work well. We'll break them as much as
+ # they are breaking us.
+ precmd_functions=(${precmd_functions:#_ghostty_precmd} _ghostty_precmd)
+ # Plugins that invoke precmd hooks from zle do that before zle
+ # is trashed. This means that the cursor is in the middle of
+ # BUFFER and we cannot print our mark there. Prompt might
+ # already have a mark, so the following reset-prompt will write
+ # it. If it doesn't, there is nothing we can do.
+ if ! builtin zle; then
+ builtin print -rnu $_ghostty_fd -- $mark1[3,-3]
+ (( _ghostty_state = 2 ))
+ fi
+ fi
+ elif ! builtin zle; then
+ # Without prompt_percent we cannot patch prompt. Just print the
+ # mark, except when we are invoked from zle. In the latter case we
+ # cannot do anything.
+ builtin print -rnu $_ghostty_fd -- $mark1[3,-3]
+ (( _ghostty_state = 2 ))
+ fi
+ }
+
+ _ghostty_preexec() {
+ builtin emulate -L zsh -o no_warn_create_global -o no_aliases
+
+ # This can potentially break user prompt. Oh well. The robustness of
+ # this code can be improved in the case prompt_subst is set because
+ # it'll allow us distinguish (not perfectly but close enough) between
+ # our own prompt, user prompt, and our own prompt with user additions on
+ # top. We cannot force prompt_subst on the user though, so we would
+ # still need this code for the no_prompt_subst case.
+ PS1=${PS1//$'%{\e]133;A\a%}'}
+ PS2=${PS2//$'%{\e]133;A;k=s\a%}'}
+
+ # This will work incorrectly in the presence of a preexec hook that
+ # prints. For example, if MichaelAquilina/zsh-you-should-use installs
+ # its preexec hook before us, we'll incorrectly mark its output as
+ # belonging to the command (as if the user typed it into zle) rather
+ # than command output.
+ builtin print -nu $_ghostty_fd '\e]133;C\a'
+ (( _ghostty_state = 1 ))
+ }
+
+ # Enable reporting current working dir to terminal. Ghostty supports
+ # the kitty-shell-cwd format.
+ _ghostty_report_pwd() { builtin print -nu $_ghostty_fd '\e]7;kitty-shell-cwd://'"$HOST""$PWD"'\a'; }
+ chpwd_functions=(${chpwd_functions[@]} "_ghostty_report_pwd")
+ # An executed program could change cwd and report the changed cwd, so also report cwd at each new prompt
+ # as in this case chpwd_functions is insufficient. chpwd_functions is still needed for things like: cd x && something
+ functions[_ghostty_precmd]+="
+ _ghostty_report_pwd"
+ _ghostty_report_pwd
+
+ # Enable cursor shape changes depending on the current keymap.
+ # This implementation leaks blinking block cursor into external commands
+ # executed from zle. For example, users of fzf-based widgets may find
+ # themselves with a blinking block cursor within fzf.
+ _ghostty_zle_line_init _ghostty_zle_line_finish _ghostty_zle_keymap_select() {
+ case ${KEYMAP-} in
+ # Blinking block cursor.
+ vicmd|visual) builtin print -nu "$_ghostty_fd" '\e[1 q';;
+ # Blinking bar cursor.
+ *) builtin print -nu "$_ghostty_fd" '\e[5 q';;
+ esac
+ }
+ # Restore the blinking default shape before executing an external command
+ functions[_ghostty_preexec]+="
+ builtin print -rnu $_ghostty_fd \$'\\e[0 q'"
+
+ # Some zsh users manually run `source ~/.zshrc` in order to apply rc file
+ # changes to the current shell. This is a terrible practice that breaks many
+ # things, including our shell integration. For example, Oh My Zsh and Prezto
+ # (both very popular among zsh users) will remove zle-line-init and
+ # zle-line-finish hooks if .zshrc is manually sourced. Prezto will also remove
+ # zle-keymap-select.
+ #
+ # Another common (and much more robust) way to apply rc file changes to the
+ # current shell is `exec zsh`. This will remove our integration from the shell
+ # unless it's explicitly invoked from .zshrc. This is not an issue with
+ # `exec zsh` but rather with our implementation of automatic shell integration.
+
+ # In the ideal world we would use add-zle-hook-widget to hook zle-line-init
+ # and similar widget. This breaks user configs though, so we have do this
+ # horrible thing instead.
+ builtin local hook func widget orig_widget flag
+ for hook in line-init line-finish keymap-select; do
+ func=_ghostty_zle_${hook/-/_}
+ (( $+functions[$func] )) || builtin continue
+ widget=zle-$hook
+ if [[ $widgets[$widget] == user:azhw:* &&
+ $+functions[add-zle-hook-widget] -eq 1 ]]; then
+ # If the widget is already hooked by add-zle-hook-widget at the top
+ # level, add our hook at the end. We MUST do it this way. We cannot
+ # just wrap the widget ourselves in this case because it would
+ # trigger bugs in add-zle-hook-widget.
+ add-zle-hook-widget $hook $func
+ else
+ if (( $+widgets[$widget] )); then
+ # There is a widget but it's not from add-zle-hook-widget. We
+ # can rename the original widget, install our own and invoke
+ # the original when we are called.
+ #
+ # Note: The leading dot is to work around bugs in
+ # zsh-syntax-highlighting.
+ orig_widget=._ghostty_orig_$widget
+ builtin zle -A $widget $orig_widget
+ if [[ $widgets[$widget] == user:* ]]; then
+ # No -w here to preserve $WIDGET within the original widget.
+ flag=
+ else
+ flag=w
+ fi
+ functions[$func]+="
+ builtin zle $orig_widget -N$flag -- \"\$@\""
+ fi
+ builtin zle -N $widget $func
+ fi
+ done
+
+ if (( $+functions[_ghostty_preexec] )); then
+ builtin typeset -ag preexec_functions
+ preexec_functions+=(_ghostty_preexec)
+ fi
+
+ builtin typeset -ag precmd_functions
+ if (( $+functions[_ghostty_precmd] )); then
+ precmd_functions=(${precmd_functions:/_ghostty_deferred_init/_ghostty_precmd})
+ _ghostty_precmd
+ else
+ precmd_functions=(${precmd_functions:#_ghostty_deferred_init})
+ fi
+
+ # Unfunction _ghostty_deferred_init to save memory. Don't unfunction
+ # ghostty-integration though because decent public functions aren't supposed to
+ # to unfunction themselves when invoked. Unfunctioning is done by calling code.
+ builtin unfunction _ghostty_deferred_init
+}