an extension to the help builtin of bash, with stdout colorisation and paging of bat

help.sh

#!/bin/bash

# based on https://github.com/sharkdp/bat#highlighting---help-messages
help() {
    {
        set -x
        command help "$@" 2>/dev/null
        type -P "$1" && if echo "$@" | grep -Eq '(\s-h|help)(\s|$)'; then "$@"; else "$@" --help; fi
    } |& bat -plhelp
}
complete -F _command help # https://stackoverflow.com/a/35356591/8867832