Crates.io Crates.io Build Status dependency status

bcd is a way to cd to directories that have been bookmarked.

Installation

Homebrew

bcd is not currently in the Homebrew core repository yet, however you can easily add a tap for bcd first:

sh brew tap a1ecbr0wn/bcd

then run the install:

sh brew install bcd

and then restart your shell.

Cargo

A simple way for fellow rust developers to install bcd is via the rust tool cargo:

bash cargo install bookmark-cd

Snapcraft

Working on it, once this has been approved to be in the snap store...

sh snap install bookmark-cd

Snapcraft does not allow write access to the shell init scripts which are required to set up bcd so the following commmand should be set up manually in your ~/.bashrc if you are using bash or ~/.zshrc if you are using zsh as your shell:

``` sh

bookmark-cd init block

eval "$(bookmark-cd init)"
```

Other package managers

... for any other package managers please raise an issue

Installation issues - Setup your environment

After your installation, you need to restart your shell, your installation should have automatically set up the pointer to bcd in your shell init script. If the command bcd is not working after your installation or something else has happened to change your shell scripts, running bookmark-cd and then restarting your shell should set this correctly.

At the moment, only the bash and zsh shells are supported, feel free to contribute if you are reading this and you need support for a different shell.

The following commmand should be set in your ~/.bashrc or ~/.zshrc:

``` sh

bookmark-cd init block

eval "$(bookmark-cd init)"
```

How to use: create a bookmarks

``` sh

create a bookmark to the logs directory

cd /var/log bcd logs

move to home

cd ~

list the bookmarks

bcd -l

change to the bookmarked directory

bcd logs pwd ```

Contribute

There are many shell that this tool could be used on, I just don't use them. I would be happy to take a look at any PRs that add support for other shells.