Git_SSH-Account_Switch

A CLI tool can switch ssh account to your current shell. You will easily switch to your git account & ssh key when using the server, and using your account to manipulate the project on the server.

NOTE: This tool is for the user who using Zsh on the UNIX/Linux platfrom.

Installation

$ zsh ./setup.sh

it will add some code in your profile & $logout_profile, and setup git-acc & .gitacc on the $HOME.
file:

git-acc.sh -> $HOME/.git-acc, git-acc function.
.gitacc -> $HOME/.gitacc, save info. that regist on git-acc.

Control

        +---------------+
        |    git-acc    |
        +---------------+

SYNOPSIS

  git-acc [account]|[option]

OPTIONS

  [account]               use which accounts on this shell, type the account name that you register.
  -h, --help              print help information.
  -add, --add_account     build git_account info. & ssh-key.
      -t, --type          ssh-key types, follow `ssh-keygen` rule,
                          types: dsa | ecdsa | ecdsa-sk | ed25519 | ed25519-sk | rsa(default)
  -rm, --remove_account   remove git_account info. & ssh-key from this device
  -out, --logout          logout your current ssh-acc.
  -ls, --list             list all registered accounts with their emails.
  --set-default           set a default account that auto-loads on shell startup
  --show-default          display the current default account
  --unset-default         remove the default account configuration


EXAMPLES

  $ git-acc tw-yshuang
  $ git-acc -ls
  $ git-acc --set-default tw-yshuang
  $ git-acc --show-default
  $ git-acc --unset-default

SWITCH ACCOUNT

When you want to use the account that you have already added it, you can type:

$ git-acc <tab>

Then it will come out the current account that registers in the git-acc to let you choose, e.g.

$ git-acc <tab>
tw-yshuang cool-name ...

ADD

$ git-acc -add
    or
$ git-acc --add_account

It will ask you to type:

Enter your git user name: <acc_name>
Enter your git user mail: <acc_mail>

After that, git-acc will generate id_rsa_<acc_name>, id_rsa_<acc_name>.pub in the $HOME/.ssh.
Next, you can type $ git-acc <acc_name>, to login your account.
NOTE: You also can overwrite your account.

CHOOSE YOUR SSH-KEY TYPE

If you do not want to use rsa type to create your ssh-key, you can use this:

$ git-acc -add -t <key-type>
    or
$ git-acc -add --type <key-type>

This args is following ssh-keygen -t rule, you can type corresponding key type you wnat!
Types: dsa | ecdsa | ecdsa-sk | ed25519 | ed25519-sk | rsa(default)

REMOVE

$ git-acc -rm
    or
$ git-acc --remove_account

It will ask you to type:

Enter the git user name you want to remove: <acc_name>

LOGOUT

$ git-acc -out
    or
$ git-acc --logout

Logout your ssh-acc perfectly at CLI mode.

LIST

$ git-acc -ls
    or
$ git-acc --list

Display all registered accounts with their email addresses. This helps you see which accounts are available for switching.

Example output:

Registered Git Accounts:

  - tw-yshuang         (tw.yshuang@gmail.com)
  - work-account       (user@company.com)
  - personal           (personal@email.com)

DEFAULT ACCOUNT

Set a default account that automatically loads when you open a new shell.

Set Default

$ git-acc --set-default tw-yshuang

Set an existing account as the default. The default account will be automatically loaded on your next shell startup.

Show Current Default

$ git-acc --show-default

Display the name of the currently configured default account.

Remove Default

$ git-acc --unset-default

Remove the default account configuration. Auto-load will be disabled.

Auto-load Behavior

When you have a default account configured, it will automatically activate when you open a new shell session. This means:

• The SSH agent will start automatically
• Your git user.name and user.email will be configured
• You can immediately start using git without manually running git-acc <account>

To disable auto-load, simply unset the default account or remove the [DEFAULT] section from your ~/.gitacc file.

UNINSTALL

$ ./uninstall.sh

After executing this, it will complete removing git-acc.