Dirbook is a small CLI created to help index directories/projects.
npm install -g dirbook
- Index directories, giving them names, short descriptions, and tags
- Copy an indexed directory to the current directory, giving it a new name (great for small starter-projects)
- Open an indexed directory in Finder/File Explorer
- Use tags to organize and filter directories
- Turn on aliasing to have dirbook manage a small subsection of your .bash_profile or .bashrc, creating aliases to cd into directories.
copy [-t --tag <tag>]
dirbook copy displays a list of all indexed directories. After selecting one and giving your new directory a name, a copy will be made in your current working directory.
open [-t --tag <tag>]
dirbook open displays a list of all indexed directories. After selecting one, the directory will be opened in the default file browsing app.
select [-t --tag <tag>]
dirbook select displays a list of all indexed directories. After selecting one or many, you will be given a few options. If more than one is chosen, their tags may be updated, or they may be deleted from dirbook. If only one is chosen, it may also be updated.
ls [-t --tag <tag>]
dirbook ls and
dirbook prints all indexed directories. This is the default behavior.
alias [-o --active, -f --off, -x --prefix <prefix>, -p --path <path>]
dirbook alias will print out the current alias settings (on/off, path to write to, prefix for alias).
Aliasing is off by default, and may be turned on by running
dirbook alias -o.
For aliasing to work, you will also need to give it the absolute path of the file you'd like to add aliases to. For most this will be .bash_profile or .bashrc.
Aliases will be given a prefix of
dirbook- by default to avoid overriding other command, but can be changed using
dirbook alias -x <prefix>
Turning aliasing on will add an alias for ever indexed directory, using the form
alias <prefix><name> = 'cd <path>'
Turning aliasing off will remove all aliases from
# dirbook-aliases-start alias dirbook-element-calc='cd /Users/nickroberts404/Development/Projects/element-calc' alias dirbook-thoughtjar='cd /Users/nickroberts404/Development/Projects/thoughtjar' alias dirbook-telegraph='cd /Users/nickroberts404/Development/Projects/Telegraph' # dirbook-aliases-end
(Aliases will only be available after restarting the terminal, or after calling
dirbook reset will clear dirbook and remove aliases.
Usage: dirbook [options] [command] Commands: open [options] Open the selected directory in Finder/File Explorer. add Add current directory to dirbook. copy [options] Allows you to select directory to copy. select [options] Allows you to select directories and perform actions. ls [options] List all the things. alias [options] Configure alias settings reset Wipes dirbook's memory. Options: -h, --help output usage information -V, --version output the version number