husky.node.txt

                                  ┏━━━━━━━━━━━┓
                                  ┃   HUSKY   ┃
                                  ┗━━━━━━━━━━━┛

VERSION ==>                       #9.1.7
                                  #Allows git hooks directory to be committed

                                  ┌──────────┐
                                  │   INIT   │
                                  └──────────┘

husky init                        #Adds `husky` to PACKAGE.scripts.prepare, then run `husky`

husky [HOOKS_DIR]                 #Initializes HOOKS_DIR
HOOKS_DIR                         #Def: './.husky'
                                  #Must be git committed

                                  ┌──────────┐
                                  │   HOOK   │
                                  └──────────┘

HOOKS_DIR/HOOK                    #Run on specific HOOK (pre-commit, etc.)
                                  #sh file, but no need for shebang
                                  #Receive same argument as normal git hook
                                  #Has ./node_modules/.bin/ in ENVVAR PATH
HOOKS_DIR/pre-commit              #`husky init` initializes it with "npm test"

~/.config/husky/init.sh           #Run on any HOOK
$XDG_CONFIG_HOME/husky/init.sh    #No need for shebang
                                  #Receive no argument

ENVVAR HUSKY=0                    #Make `husky` and HOOKS_DIR/HOOK a noop, but not init.sh
ENVVAR HUSKY=2                    #Use `set -x` on HOOKS_DIR/HOOK and init.sh

                                  ┌──────────────┐
                                  │   INTERNAL   │
                                  └──────────────┘

HOOKS_DIR/_                       #Internal files
                                  #`husky` sets it as git hooks path using: git config core.hooksPath HOOKS_DIR/_
                                  #Git ignored, using HOOKS_DIR/_/.gitignore with contents '*'
HOOKS_DIR/_/HOOK                  #Actual git hook, which forwards to HOOKS_DIR/_/h
HOOKS_DIR/_/h                     #Runs init.sh and HOOKS_DIR/HOOK