kireobat / git-idm-npm

git-idm-npm

git-idm-npm is a command line interface based git identity manager.

Table of contents

• git-idm-npm
  • Table of contents
    • Installation
      • Npm package (Recommended)
      • From github
      • Manually
    • Troubleshooting
      • "scripts is disabled on this system"
    • Commands
      • The help command
        • git-idm active
        • git-idm add
        • git-idm alias
        • git-idm list
        • git-idm remove
        • git-idm use

---

Installation

Npm package (Recommended)

1. npm install -g git-idm-npm

From github

1. npm install -g https://github.com/Kireobat/git-idm-npm.git

Manually

1. Download the git repository
   • Either download it as a zip file and unzip it, or
   • run git clone https://github.com/Kireobat/git-idm-npm.git
2. Install it from the files you downloaded
   • run npm install -g path/to/files

---

Troubleshooting

This script has been confirmed to work on:

• Windows
  • 10
  • 11
• Linux
• MacOS

"scripts is disabled on this system"

If you get the following error message:

git-idm : File C:\path\to\nodejs\git-idm.ps1 cannot be loaded because running scripts is disabled on this system.
For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ git-idm list
+ ~~~~~~~
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

The solution is to follow the path spesified at the beginning of the error message C:\path\to\nodejs\git-idm.ps1 and delete the following file: git-idm.ps1

---

Commands

Commands are sorted alphabetically

The help command

git-idm help

or

git-idm <command> --help

is availiable and provides more or less the same info as below.

git-idm active

• displays the active git identity

git-idm add

• adds a new git identity
• arguments:
  • --name=""
    • alias: --n=""
    • required
    • string
  • --email=""
    • alias: --e=""
    • required
    • string
  • --alias=""
    • alias: --a=""
    • optional
    • string

git-idm alias

• adds or changes an alias
• arguments:
  • --alias=""
    • alias: --a=""
    • required
    • string
  • --name=""
    • alias: --n=""
    • required
    • string

git-idm list

• lists every saved identity

git-idm remove

• deletes a git identitiy
• arguments:
  • --name=""
    • aliases: --n="" --a="" --alias=""
    • required
    • string

git-idm use

• set git identity for current repository or globally
• arguments:
  • --name=""
    • aliases: --n="" --a="" --alias=""
    • required
    • string
  • --global
    • alias: --g
    • optional
    • boolean

git-idm-npm's Issues

add ability to see active git identity

could be nice to have

make use and remove able to take either name or alias

by this i mean use and remove should be able to take all of these

--name
--n
--alias
--a