/zshelf

A simple zsh plugin used to bookmark files

Primary LanguageShellGNU General Public License v3.0GPL-3.0

Shelf

Shelf is a simple ZSH utility which can be used to bookmark and access directly any file using mnemonics.

Installation

Just source shelf.zsh

source /path/to/shelf.zsh

and include _shelf in your $fpath.

Using Plugin Managers

Here it this:

ecmma/shelf

You should know where it goes! In case you don't, refer to getantibody or your preferred plugin manager documentation.

Usage

usage: shelf [command] <?arg(s)>
	remove 	<id> Remove a previously added mark
	open 	<id> Open a previously added mark
	add 	<id> <file> Add a new mark with <id> to <file>
	list 	List all marks

Mark your file with shelf:

shelf add myfile /long/path/to/file.pdf

Your file will be saved and you'll be able to open it using shelf from anywhere:

shelf open myfile 

Requirements

For Linux-based distros, a resource opener such as xdg-open or mimeo is required (well, to open the file!) For macOS, the open command should be enough.