cameronharp / Go-Shell

Allows powershell users to navigate to specific directory paths in a quick and easy way.
MIT License
60 stars 12 forks source link

Go-Shell

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

image

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.