Files
fish-config/functions/ssh.fish
T
rootiest 4c51ef7a33 docs(functions): add # CATEGORY to documented function headers
Records each documented function's manual category in its own header, so
Section 5 can later be generated from source instead of hand-maintained
alongside it. Values reproduce the current grouping in
docs/manual/05-functions/ exactly; no documentation changes meaning here.

Four functions are skipped because they have no header at all yet
(branch, fc, gitup, sudo-toggle); they get one in the merge that follows.
2026-07-26 03:44:03 -04:00

33 lines
810 B
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 08-terminal-management
#
# SYNOPSIS
# ssh [args...]
#
# DESCRIPTION
# Wraps ssh with kitten ssh inside Kitty terminal for better terminal
# integration (e.g. terminfo forwarding). Falls back to system ssh on
# other terminals.
#
# ARGUMENTS
# args... Arguments forwarded to kitten ssh or system ssh
#
# EXAMPLE
# ssh user@host
function ssh --description 'Alias ssh to kitten ssh when using Kitty terminal'
# Opinionated guard (C1): fall back to bare command ssh when disabled.
if not __fish_config_op_enabled __fish_config_op_aliases
command ssh $argv
return $status
end
if test "$TERM" = xterm-kitty
kitten ssh $argv
else
command ssh $argv
end
end