oh-my-bash/plugins/bashmarks

Bashmarks plugin

The Bashmarks plugin allows you to create and use bookmarks for directories on your filesystems. This plugin is derived from the project https://github.com/huyng/bashmarks but contains improvements. This plugin is licensed under the 3-Clause BSD license.

Quickstart

Create a new bookmark using the bm -a command:

$ bm -a mydir

The command above creates a bookmark for the current directory with the name mydir.

You can navigate to the location of a bookmark using the bm -g command:

$ bm -g mydir

You can also supply just any bookmark name and the -g option will be assumed:

$ bm mydir

Tab completion is available when you need to enter a bookmark name in a command, such as when using bm -g

Easily list all bookmarks you have set up using the bm -l command:

$ bm -l

Configuration

• BASHMARKS_SDIR: This variable contains the path to the file that stores the information of bookmarks of directory names. The default path is ~/.sdirs. The old interface SDIRS is now deprecated.

Commands

• bm -h: Print short help text
• bm -a bookmarkname: Save the current directory as bookmarkname
• bm [-g] bookmarkname: Go to the specified bookmark
• bm -p bookmarkname: Print the bookmark
• bm -d bookmarkname: Delete a bookmark
• bm -l: List all bookmarks

Valid bookmark names

A bookmark name can contain lower and upper case characters (A-Z), numbers and underscore characters. No periods, semicolons, spaces or other characters are allowed in a bookmark name.