trail-fm 1.11.1

A terminal-first workspace for navigating, inspecting and acting on the filesystem
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

# Bash/POSIX-sh wrapper for the `trail` terminal file manager.

#

# Source this file in your ~/.bashrc (or ~/.bash_profile) to enable the

# "cd-on-exit" behaviour: when you quit Trail normally (`q`), your current

# shell session changes to the directory Trail was browsing.

#

# Installation:

#   echo 'source /path/to/trail.bash' >> ~/.bashrc

#   source ~/.bashrc

#

# Usage:

#   trail [<start-path>]      # launches Trail; on normal exit, `cd`s to the

#                             # last-visited directory.

#

# How it works:

#   The wrapper creates a temporary file and passes its path to the Trail

#   binary via --cwd-file.  On a normal exit Trail writes its current

#   directory to that file; the wrapper reads it, removes it, then `cd`s

#   into the directory.  On cancellation (Ctrl-c / Esc quit) Trail writes

#   nothing, so the shell stays where it was.


trail() {
    local tmp

    tmp="$(mktemp)" || return 1

    command trail --cwd-file "$tmp" "$@"

    local exit_code=$?

    if [ -f "$tmp" ]; then
        local dir

        dir="$(cat "$tmp")"
        rm -f "$tmp"

        [ -d "$dir" ] && cd -- "$dir"

    else
        rm -f "$tmp"

    fi

    return $exit_code

}