Skip to content
forked from zpm-zsh/bookmarks

A port of Bashmarks (simple bookmarking plugin by Todd Werth) for oh-my-zsh

Notifications You must be signed in to change notification settings

gador/bookmarks

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

84 Commits
 
 
 
 
 
 
 
 

Repository files navigation

zshmarks

A port of Bashmarks (by Todd Werth), a simple command line bookmarking plugin, for oh-my-zsh

Commands/Usage:

  • c - used to cd to the given bookmark directory.
c foo
  • mark - used to create a new bookmark for your current working directory
cd 'some_dir'
mark foo
# Or
mark # Will be added as `some_dir`
  • delmark - used to delete a bookmark
delmark foo
# Or
delmark foo bar baz # Remove multiple bookmarks
# Or
delmark # Will delete current dir from bookmarks
  • marks - prints a list of all saved bookmarks, or print the directory information for a single, specific bookmark
marks # Show all marks
# Or 
marks foo # Show path to bookmark

Notes/Tips:

You can change the location of the bookmarks file (default is $HOME/.bookmarks) by adding the environment variable 'BOOKMARKS_FILE' to your shell profile.

export BOOKMARKS_FILE="foo/bar"

If you were expecting this to be a port of similarly named Bashmarks (by huyng), you can setup zshmarks to behave in roughly the same way by adding the following aliases to your shell setup files/dotfiles:

alias g="c"
alias s="mark"
alias d="delmark"
alias p="marks"
alias l="marks"

(You can also omit the "l" alias, and just use p without an argument to show all bookmarks.)

How to install

  • Download the script or clone this repository in oh-my-zsh plugins directory:
cd ~/.oh-my-zsh/custom/plugins
git clone https://github.com/zpm-zsh/zshmarks.git
  • Activate the plugin in ~/.zshrc:
plugins=( [plugins...] zshmarks [plugins...])
  • Restart shell

Add the following to your .zshrc file somewhere after you source zpm.

zpm load "zpm-zsh/zshmarks"

Add antigen bundle zpm-zsh/zshmarks to your .zshrc where you're adding your other plugins. Antigen will clone the plugin for you and add it to your antigen setup the next time you start a new shell.

For most people the easiest way to use zshmarks with prezto is to manually clone the zshmarks repo to a directory of your choice (e.g. /usr/local or ~/bin) and symlink the zshmarks folder into your zpretzo/modules folder:

ln -s ~/bin/zshmarks ~/.zprezto/modules/zshmarks

Alternatively, you can add the zshmarks repository as a submodule to your prezto repo by manually editing the '.gitmodules' file:

[submodule "modules/zshmarks"]
        path = modules/zshmarks
        url = https://github.com/zpm-zsh/zshmarks.git

Then make sure you activate the plugin in your .zpreztorc file:

zstyle ':prezto:load' pmodule \
zshmarks \
...

Add the following to your .zshrc file somewhere after you source zplug.

zplug "zpm-zsh/zshmarks"

About

A port of Bashmarks (simple bookmarking plugin by Todd Werth) for oh-my-zsh

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%