caveman-dick/go-shell

Allows powershell users to navigate to specific directory paths in a quick and easy way.

#Go-Shell#

Allows PowerShell users to navigate to a specific directory in a quick and easy way using bookmarks.

###NOTE### The below gif shows the old command-line which was renamed to gd so prevent a clash with the GoLang command. Just swap all the go commands for gd!

##Installation##

If you have PsGet installed you can simply execute the following:

######PowerShell 3###### Install-Module Go

######PowerShell 2###### Install-Module Go -AddToProfile

####Manual Install####

1. Copy Go.psm1 to your modules folder (e.g. $Env:PSModulePath\Go\)
2. Execute Import-Module Go (or add this command to your profile)
3. Bookmark away!

####Customization#### Go-Shell stores its data normally in two files located in the ~\AppData\Local\Go\-folder.

This is changeable by setting this in your profile:

$Global:GoDataDirectory = "$([Environment]::GetFolderPath('LocalApplicationData'))\Go\"
$Global:GoRememberFileName = "go-shell-remember-last.txt"
$Global:GoBookmarkFileName = "go-shell.txt"

The values above are the defaults.

##How to Use Go##

Usage:
    gd label
    gd label -delete or -d
    gd label -show or -s
    gd label -add or -a
    gd label C:\SomePath -add or -a
    gd -showAll or -sa
    gd -clear or -c
    gd -last or -l

Switches:
    -add or -a             Adds the current directory.
    -delete or -d          Remove the given key from the directory.
    -showAll or -sa        Show all the keys and values in the directory.
    -show or -s            Show the specific key and value.
    -clear or -c           Clears all the keys and values in the directory.
    -last or -l            Goes to the last used go key.
    -help or -h            Displays this screen.

Tips:
    - Pressing the tab button after a few letters will auto fill the rest of the bookmark keyword.