Skip to content
/ cdbk Public

A ZSH plugin to allow easy named directory creation - shortcuts to any directory you want

License

Notifications You must be signed in to change notification settings

MikeDacre/cdbk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 

Repository files navigation

cdbk

A simple zsh function to make management of zsh named directories easier. It keeps all named directories in a file and uses grep, sed, echo, and perl to parse and modify this file in order to add, change or remove bookmarks.

Because it uses the zsh named directory function, full zsh path completion is possible. For example, if you wanted to access the directory /Users/me/Work/Project13/Samples/FromEster/July/ and that directory had many subdirectories including the subdirectory ./Revision6/pictures, you could easily bookmark the parent directory with the command:

cdbk -a ejul /Users/me/Work/Project13/Samples/FromEster/July/

Then, to cd to the subdirectory, just type cd ~ejul/Revision6/pictures, autocompletion will work too.

This file also provides the function folder_name(), which returns a formatted list of the names of the current folder for use in a prompt. To include the folder name in your prompt use e.g.: export PROMPT=$PROMPT $(folder_name)

Very simple cdbk completion is included to make replacing and deleting bookmarks easier.

This program was heavily inspired by Stan Angeloff's function of the same name found here: http:https://blog.angeloff.name/post/1027007406/cd-with-bookmarks-and-auto-completion-for-zsh

Usage: cdbk {-a,-r,-d,-l} <name> [path] (run with no paramaters for info)
       -a: Create bookmark (uses current dir if no path)
       -r: Replace bookmark (uses current dir if no path)
       -d: Delete bookmark
       -l: List all currently enabled bookmarks

Requirements: Needs to be sourced from a zsh startup file, or use oh-my-zsh

Installation

If you're using Antigen, just add antigen bundle MikeDacre/cdbk to your .zshrc file where you're loading your other zsh plugins.

  1. mkdir -p ~/oh-my-zsh/custom/plugins
  2. cd ~/oh-my-zsh/custom/plugins
  3. git clone [email protected]:MikeDacre/cdbk.git
  4. echo "plugins+=(cdbk)" >> ~/.zshrc

If you're using Zgen, add zgen load MikeDacre/cdbk to your .zshrc file where you're loading your other zsh plugins.

Created by: Mike Dacre

Created on: 19-11-11

Version: 1.1

License: MIT License - Open Source. Use as you wish

About

A ZSH plugin to allow easy named directory creation - shortcuts to any directory you want

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages