Files
fish-config/functions/spwin.fish
T
Claude fceddfc43f docs: add DEPENDENCIES sections to function doc headers
Documents what each function needs for full functionality -- other
repo functions it calls, and external CLI tools it uses or falls
back gracefully without (e.g. rm/trash, ls/eza+lsd) -- matching the
existing CLASSIFICATION convention's placement and the ~20 functions
that already carried this label.

Also broadens verify-manual.py's dependency-resolution check to
recognize this repo's other existence-check idioms (command -q,
command -v, which -- not just type -q) and dng2avif's dynamic
type -q $cmd loop, since several genuine dependencies (eza, lsd,
fastfetch, fd, ps, ...) are only ever guarded that way.
2026-09-22 22:22:27 -04:00

52 lines
1.3 KiB
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 08-terminal-management
#
# COMPONENT
# integrations/window-mgmt
#
# DEPENDENCIES
# kitty
#
# SYNOPSIS
# spwin [args...]
#
# DESCRIPTION
# Spawns a new terminal OS window in Kitty (via spawn-window.sh if
# present, otherwise kitty @ launch) or WezTerm (via wezterm cli spawn).
#
# ARGUMENTS
# args... Arguments forwarded to the spawn command
#
# EXIT STATUS
# 0 Window opened successfully
# 1 Not running inside Kitty or WezTerm
#
# EXAMPLE
# spwin
function spwin --wraps='~/.config/kitty/spawn-window.sh' --description 'spawn window in kitty or wezterm'
__fish_help_header (status current-function) $argv; and return 0
# Opinionated guard (C4): integrations disabled
if not __fish_config_op_enabled (status current-function)
__fish_palette
echo "$c_err"'spwin: disabled by __fish_config_op_integrations'"$c_reset" >&2
return 1
end
if test "$TERM" = xterm-kitty
if test -x ~/.config/kitty/spawn-window.sh
~/.config/kitty/spawn-window.sh $argv
else
kitty @ launch --type=window $argv
end
else if test "$TERM_PROGRAM" = WezTerm
wezterm cli spawn $argv
else
echo "Error: The 'spwin' command requires Kitty or WezTerm." >&2
return 1
end
end