rootiest
00f70e8558
Word-level diff of every manual entry against its generated counterpart surfaced 546 tokens present in the manual and absent from the header — losses reconcile.py missed, because it compared description length and these headers are longer overall thanks to ARGUMENTS/RETURNS. Merged the substantive ones (546 -> 202 residual tokens, the remainder being synonym drift). Notable real fixes: - git-clean: -f/--force was missing from ARGUMENTS entirely - pkg: per-package-manager query table - qc: cli-role rationale, role paths, --role passthrough - config-help: site URL, xdg-open, man page path, case-insensitivity - agents-init: idempotency, .gitignore paths, upstream pull, wrapper callers - smart_exit: exit-builtin wiring note, $SCROLLBACK_HISTORY_DIR The manual's claim that claude/agy pass `agents-init --agents` is stale; both pass `--quiet` (full setup). Header wins, manual dropped.
56 lines
1.7 KiB
Fish
56 lines
1.7 KiB
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# CATEGORY
|
|
# 01-file-and-directory
|
|
#
|
|
# SYNOPSIS
|
|
# cat [args...]
|
|
#
|
|
# DESCRIPTION
|
|
# Enhanced cat replacement. Wraps bat for files, giving syntax highlighting
|
|
# and line numbers; passes directories to ls; falls back to raw cat for
|
|
# ANSI-colored log files, and finally to /usr/bin/cat if bat is not
|
|
# installed.
|
|
#
|
|
# ARGUMENTS
|
|
# args... Files or directories to display
|
|
#
|
|
# EXAMPLE
|
|
# cat README.md
|
|
# cat ~/projects/myapp
|
|
function cat --wraps='bat' --description 'Use bat for files, ls for directories, and raw cat for ANSI logs'
|
|
# Opinionated guard (C1): fall back to bare command cat when disabled.
|
|
if not __fish_config_op_enabled __fish_config_op_aliases
|
|
command cat $argv
|
|
return $status
|
|
end
|
|
|
|
# If no arguments are provided, cat usually waits for stdin.
|
|
# We'll maintain that behavior by skipping the directory check if $argv is empty.
|
|
if set -q argv[1]
|
|
if test -d $argv[1]
|
|
# If it's a directory, run your custom ls function
|
|
ls $argv
|
|
return
|
|
end
|
|
|
|
# NEW: Check if the target file lives in your scrollback snapshot directory OR
|
|
# contains raw terminal ANSI color escape sequences.
|
|
if test -f $argv[1]
|
|
if string match -q "$SCROLLBACK_HISTORY_DIR/*" $argv[1]
|
|
or string match -qr -- '\e\[[0-9;]*m' (head -n 5 $argv[1] 2>/dev/null)
|
|
command cat $argv
|
|
return
|
|
end
|
|
end
|
|
end
|
|
|
|
# Fallback to bat or standard cat
|
|
if type -q bat
|
|
bat --plain --no-pager $argv
|
|
else
|
|
command cat $argv
|
|
end
|
|
end
|