fish-shell/share/functions/nextd.fish

function nextd --description "Move forward in the directory history"

    if count $argv >/dev/null
        switch $argv[1]
            case -h --h --he --hel --help
                __fish_print_help nextd
                return 0
        end
    end

    # Parse arguments
    set -l show_hist 0
    set -l times 1
    if count $argv >/dev/null
        for i in (seq (count $argv))
            switch $argv[$i]
                case '-l' --l --li --lis --list
                    set show_hist 1
                    continue
                case '-*'
                    printf (_ "%s: Unknown option %s\n" ) nextd $argv[$i]
                    return 1
                case '*'
                    if test $argv[$i] -ge 0 ^/dev/null
                        set times $argv[$i]
                    else
                        printf (_ "%s: The number of positions to skip must be a non-negative integer\n" ) nextd
                        return 1
                    end
                    continue
            end
        end
    end

    # Traverse history
    set -l code 1
    if count $times >/dev/null
        for i in (seq $times)
            # Try one step backward
            if __fish_move_last dirnext dirprev

                # We consider it a success if we were able to do at least 1 step
                # (low expectations are the key to happiness ;)
                set code 0
            else
                break
            end
        end
    end

    # Show history if needed
    if test $show_hist = 1
        dirh
    end

    # Set direction for 'cd -'
    if test $code = 0 ^/dev/null
        set -g __fish_cd_direction prev
    end

    # All done
    return $code
end