rootiest
aef686af86
Rename the C1 history() shadow to pretty-history so it never collides with the fish builtin -- every function expecting stock history semantics (search, --max, merge, ...) would otherwise silently break. hist.fish, which relied on the shadow's timestamp formatting, now requests it explicitly via builtin history --show-time. Add a CLASSIFICATION doc-header label so a function can declare its interaction with C1-shadowed commands (uses-shadow/bypasses-shadow) and general hazards (destructive, network, blocking-prompt) for anyone deciding to disable an opinionated category or call the function from automation. Wired into the manual/site build pipeline (manualtools.py, build-manual.py) and the C1 shadow doc gets a new "For function authors" bypass-mechanism reference table (command/builtin/__original_help, and which shadows have no real bypass target at all).
47 lines
1.3 KiB
Fish
47 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, xclip,
|
|
# or win32yank (WSL2).
|
|
#
|
|
# DEPENDENCIES
|
|
# _fish_clipboard_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)
|
|
__fish_palette
|
|
echo "$c_err"'hist: disabled by __fish_config_op_integrations'"$c_reset" >&2
|
|
return 1
|
|
end
|
|
|
|
set -l selected (builtin history --show-time='%F %T ' | 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 | _fish_clipboard_copy 2>/dev/null
|
|
commandline -r $command
|
|
end
|
|
end
|