vf
Enhanced version of the standard “cd” command
Usage
Like “cd”
Use a real path :
vf /go/to/the/desired/path vf ../here vf ~/documents vf - vf
If you use option -f, vf will try to find the desired directory for you :
$ pwd /Users/greg $ vf -f github $ pwd /Users/greg/dev/github
Use alias
Create an alias :
vf /go/to/the/desired/path vf -s myalias
Then if you want to go to /go/to/the/desired/path :
vf myalias
Remove an alias :
vf -r myalias
List your alias :
vf -l
Use history
Consult your history :
vf -H
This will display a list like :
... 3 : ~ 2 : /Users/greg/Documents/CouchDB 1 : /Users/greg/temp/Leonhard
Then you can use +N to go back to N :
vf +2 # I'm now in /Users/greg/Documents/CouchDB
autojump mode
Consult tour statistics :
vf -j
This will display a list like :
Statistics : /Users/greg/.vf : 8 /Users/greg/VIDAL/Dev/github/merlin : 4 /Users/greg/Dev/github : 4 /Users/greg : 1 /Users/greg/VIDAL/Dev/github : 1 /Users/greg/Dev/github/vf : 9
Then use the -j option again to go to the most visited directory :
vf -j github # I'm now in /Users/greg/Dev/github/vf
Configuration
Display the current configuration :
vf --config show
Here is the default result :
Configuration : history_max_size = 50 history_display_size = 10 auto_find = false local_directory_first = true
-
history_max_size is the history size (see “history” bellow)
-
history_display_size is the history size, displayed by the -H option (see “history” bellow)
-
auto_find allow vf to find the directory, or not (see -f option)
-
local_directory_first set to true will look if ./dir exist before looking in the alias list
If you want to change an options, use --config :
vf --config history_display_size 15
More ?
If you need more help :
vf -h
Install
Clone the repository in your prefered directory :
git clone git://github.com/glejeune/vf
Then add the following line in your .bashrc, .zshrc, .your shellrc :
source /path/to/vf/vf.sh
If sometimes you think you are a guinea pig, you can try the experimental completion system. To do it, use vf-comp.sh instead of vf.sh.
ZSH Users, if you use vf-comp.sh, be sure to load compinit before!
It does not work to me
Sorry dude!
vf was tested on MacOSX only, but you can help…
Contributing to vf
-
Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
-
Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
-
Fork the project
-
Start a feature/bugfix branch
-
Commit and push until you are happy with your contribution
-
Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.