rootiest
dccf897c9f
Fills the gaps recorded in JOB-BRIEF-FINDINGS.md for the functions converted to header-driven --help: 16 argument-less functions gain an EXIT STATUS section (check_fish_deps, claude-docs, claude-pr, cleanup, fast, fzf-update, gip, gip4, hist, limine-edit, lock, ports, screensleep, steam-dl, swapstat, tmux-clean), and 8 functions that already document ARGUMENTS gain EXIT STATUS too (lD, lsr, lss, lstree, lt, ltr, lx, qr). Not touched: gip6, ld, parur, sudo-toggle, upgrade, the JOB-BRIEF's 'missing ARGUMENTS' group. Re-checked their bodies against that claim -- none of the five take a positional argument ($argv only appears forwarded to the --help check), so an ARGUMENTS section would document something that doesn't exist. All five already have EXIT STATUS.
44 lines
1.3 KiB
Fish
44 lines
1.3 KiB
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# CATEGORY
|
|
# 04-git-and-version-control
|
|
#
|
|
# COMPONENT
|
|
# integrations/history-logs
|
|
#
|
|
# SYNOPSIS
|
|
# hist
|
|
#
|
|
# DESCRIPTION
|
|
# Searches fish history interactively using fzf, inserts the selected command
|
|
# into the command line, and copies it to the clipboard via wl-copy.
|
|
#
|
|
# EXIT STATUS
|
|
# 0 Command selected and inserted, or fzf was cancelled
|
|
# 1 Disabled by __fish_config_op_integrations
|
|
#
|
|
# EXAMPLE
|
|
# hist
|
|
function hist --description 'Search fish history and put it in the prompt'
|
|
__fish_help_header (status current-function) $argv; and return 0
|
|
|
|
# Opinionated guard (C4): integrations disabled
|
|
if not __fish_config_op_enabled (status current-function)
|
|
set -l c_err (set_color red)
|
|
set -l c_reset (set_color normal)
|
|
echo "$c_err"'hist: disabled by __fish_config_op_integrations'"$c_reset" >&2
|
|
return 1
|
|
end
|
|
|
|
set -l selected (history | fzf --reverse --height 40% --with-nth 3..)
|
|
|
|
if test -n "$selected"
|
|
# Strip the timestamp for the final output
|
|
set -l command (echo $selected | string replace -r '^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} ' '')
|
|
|
|
echo $command | wl-copy 2>/dev/null
|
|
commandline -r $command
|
|
end
|
|
end
|