pxh 0.9.23

pxh is a fast, cross-shell history mining tool with interactive fuzzy search, secret scanning, and bidirectional sync across machines. It indexes bash and zsh history in SQLite with rich metadata for powerful recall.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

preexec() {
    local cmd="$1"
    [ -z "$cmd" ] && return 1
    [[ "$cmd" =~ ^[[:space:]] ]] && return 1
    local started=$(date +%s)
    pxh \
	--db "$PXH_DB_PATH" \
	insert \
	--working-directory "$PWD" \
	--hostname "$PXH_HOSTNAME" \
	--shellname bash \
	--username "$USER" \
	--session-id "$PXH_SESSION_ID" \
	--start-unix-timestamp "$started" \
	-- "$cmd"
}

precmd() {
    local retval=$?
    local ended=$(date +%s)
    pxh \
	--db "$PXH_DB_PATH" \
	seal \
	--session-id "$PXH_SESSION_ID" \
	--end-unix-timestamp "$ended" \
	--exit-status "$retval"
}

_pxh_random() {
    od -An -N6 -tu8 < /dev/urandom | tr -d '\n '
}

__pxh_should_run=""

_pxh_recall() {
    __pxh_should_run=""
    local selected
    selected=$(pxh --db "$PXH_DB_PATH" recall --shell-mode --query "$READLINE_LINE" 2>/dev/null)
    if [[ "$selected" == run:* ]]; then
        READLINE_LINE="${selected#run:}"
        READLINE_POINT=${#READLINE_LINE}
        __pxh_should_run=1
    elif [[ "$selected" == edit-a:* ]]; then
        READLINE_LINE="${selected#edit-a:}"
        READLINE_POINT=0
    elif [[ "$selected" == edit:* ]]; then
        READLINE_LINE="${selected#edit:}"
        READLINE_POINT=${#READLINE_LINE}
    fi
}

_pxh_check_run() {
    if [[ "$__pxh_should_run" == 1 ]]; then
        __pxh_should_run=""
        bind '"\C-x3": accept-line'
    else
        bind '"\C-x3": ""'
    fi
}

_pxh_init() {
    export PXH_SESSION_ID=$(_pxh_random)
    export PXH_HOSTNAME=$(hostname -s)
    if [ -z "${PXH_DB_PATH:-}" ]; then
        local xdg_dir="${XDG_DATA_HOME:-$HOME/.local/share}/pxh"
        if [ -d "$xdg_dir" ]; then
            export PXH_DB_PATH="$xdg_dir/pxh.db"
        elif [ -d "$HOME/.pxh" ]; then
            export PXH_DB_PATH="$HOME/.pxh/pxh.db"
        else
            export PXH_DB_PATH="$xdg_dir/pxh.db"
        fi
    fi

    [ ! -d "$(dirname "$PXH_DB_PATH")" ] && mkdir -p -m 0700 "$(dirname "$PXH_DB_PATH")"

    # Bind Ctrl-R to pxh recall via macro chain: # PXH_CTRL_R_BINDING
    # \C-x1 runs recall, \C-x2 checks if we should execute, # PXH_CTRL_R_BINDING
    # \C-x3 is dynamically bound to accept-line or no-op # PXH_CTRL_R_BINDING
    bind -x '"\C-x1": _pxh_recall' # PXH_CTRL_R_BINDING
    bind -x '"\C-x2": _pxh_check_run' # PXH_CTRL_R_BINDING
    bind '"\C-x3": ""' # PXH_CTRL_R_BINDING
    bind '"\C-r": "\C-x1\C-x2\C-x3"' # PXH_CTRL_R_BINDING
}

_pxh_init