Prj

Cd to your project the right way!

Prj chooses a project directory based on fuzzy matching.

It finds a project directory (a directory with .git/ or other vcs directory inside) such that it's name contains supplied letters in given order. The search is scoped by projects root directory, which is specified in ~/.prj.yml config file (Default: ~/Projects). See Installation & Configuration section.

now even faster with C extension

Installation & Configuration:

1. Install the gem:

   gem install prj

2. Configure your shell:

• (oh-my-zsh users) Put scripts/zsh/prj.plugin.zsh into ~/.oh-my-zsh/custom/plugins/prj/prj.plugin.zsh. Don't forget to enable the plugin in ~/.zshrc

• (bash users) Add the following snippet to your .bash_profile:

  function p() {
      builtin cd "$(prj $1)"
  }
  

3. Put a project root directory name into ~/.prj.yml, i.e:

   projects_root: ~/Projects
   case_sensitive: false                 # default: true
   search_nested_repositories: false     # default: false (slower if true)
   vcs_directories:                      # default: [.git]
     - .git
     - .svn
     - .hg
   

Usage:

With the following directory structure

~/
  Projects/
    my_super_project/
    rails/
    love_hate_unicorns/

You can reach ~/Projects/my_super_project with p msp