trail-fm 1.13.0

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

# Zsh wrapper for the `trail` terminal file manager.

#

# Source this file in your ~/.zshrc 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.zsh' >> ~/.zshrc

#   source ~/.zshrc

#

# 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

}