Neutrino Packing Machine


    0.5.1-alpha • Public • Published



    npm version GitHub Build Status Language grade: JavaScript Total alerts

    A command line tool allowing for easy shifting between git identities (username, email, and GPG).

    Version: 0.5.1-alpha
    Author: Luiserebii


    Usage: git-identity [options]
      -v, --version          output the version number
      -a, --about            about this tool
      -l, --list             list all registered identities
      -n, --new <name> *     add new identity
      -u, --update <name> *  update registered identity
      -d, --delete <name>    delete registered identity
      -s, --shift <name>     shift git identity to registered identity (global by default)
      -c, --current          current global git identity
      --global               global (option for -s and -c)
      --local                local (option for -s and -c)
      --user <username>      specify username
      --email <email>        specify email
      --gpg-key <gpg-key>    specify GPG key (key-id format: LONG)
      -h, --help             output usage information
    * uses additional flags below: 
    --user, --email, --gpg-key
    Usage: clone [options] [repo]
    Clone a repository and set the identity locally within. All flags accepted by git clone can also be used with this tool, and more information on their usage can be found within the git-scm documentation.
      -i, --identity <name>            name of the git-identity to use
      -v, --verbose                    be more verbose
      -q, --quiet                      be more quiet
      --progress                       force progress reporting
      -n, --no-checkout                don't create a checkout
      --bare                           create a bare repository
      --mirror                         create a mirror repository (implies bare)
      -l, --local                      to clone from a local repository
      --no-hardlinks                   don't use local hardlinks, always copy
      -s, --shared                     setup as shared repository
      --recursive                      initialize submodules in the clone
      --recurse-submodules             initialize submodules in the clone
      --template <template-directory>  directory from which templates will be used
      --reference <repo>               reference repository
      --dissociate                     use --reference only while cloning
      -o, --origin <name>              use <name> instead of 'origin' to track upstream
      -b, --branch <branch>            checkout <branch> instead of the remote's HEAD
      -u, --upload-pack <path>         path to git-upload-pack on the remote
      --depth <depth>                  create a shallow clone of that depth
      --single-branch                  clone only one branch, HEAD or --branch
      --separate-git-dir <gitdir>      separate git dir from working tree
      -c, --config <key=value>         set config inside the new repository
      -h, --help                       output usage information



    To install, simply extract the tool into a preferred directory, compile, and create a soft link. For example, if you are looking to place the tool in your home directory:

    unzip -d ~/
    cd ~/git-identity-0.5.1-alpha
    npm install
    npm run build
    sudo chmod u+x ~/git-identity-0.5.1-alpha/git-identity
    sudo ln -s ~/git-identity-0.5.1-alpha/git-identity /usr/local/bin/git-identity

    Doing this should make it globally accessible via git-identity.

    Alternatively, there is an INSTALL and UPDATE script, the latter of which should take any registered identities you had in the previous install and copy them over. NOTE: These are still untested and could break easily; until test cases are released for these, tread with caution.


    A mirror of this repository is available at:


    Questions? Comments? Suggestions?
    Open an issue, make a pull request!

    Or, you can email me at:




    npm i @luiserebii/git-identity

    DownloadsWeekly Downloads






    Unpacked Size

    43.2 kB

    Total Files


    Last publish


    • luiserebii