@anhducmata/git-manager 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,146 @@
+# @anhducmata/git-manager
+
+> Instantly switch between multiple Git accounts (SSH keys + user config) on a single machine.
+
+If you use **multiple GitHub/GitLab accounts** on one laptop (e.g. Work + Personal), this CLI tool lets you switch between them in seconds — including the SSH key, so `git push` always goes to the right account.
+
+---
+
+## ✨ Features
+
+- **One command to switch** — changes `user.name`, `user.email`, and SSH key all at once
+- **Auto-generates SSH keys** — creates a dedicated `ed25519` key per profile
+- **No more SSH conflicts** — uses `core.sshCommand` with `IdentitiesOnly=yes` so Git always uses the correct key
+- **Interactive prompts** — no flags to memorize, just follow the menu
+- **Lightweight** — zero config files to edit manually
+
+---
+
+## 📦 Installation
+
+```bash
+npm install -g @anhducmata/git-manager
+```
+
+After installing, the `gitm` command is available globally.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Add your first account
+
+```bash
+gitm new
+```
+
+You'll be asked for:
+- **Profile name** — a label like `Work` or `Personal`
+- **Git user.name** — the name that appears on your commits
+- **Git user.email** — the email tied to your Git provider
+- **SSH key** — press Enter to auto-generate a new `ed25519` key, or provide a path to an existing one
+
+After the key is generated, the tool prints your **public key** so you can copy it into GitHub/GitLab:
+
+```
+ssh-ed25519 AAAAC3Nza... your-email@example.com
+```
+
+> 💡 Add this key to your Git provider:
+> - **GitHub**: Settings → SSH and GPG keys → New SSH key
+> - **GitLab**: Preferences → SSH Keys → Add new key
+
+### 2. Add your second account
+
+```bash
+gitm new
+```
+
+Repeat the same process for your other account (e.g. `Personal`).
+
+### 3. Switch between accounts
+
+```bash
+gitm switch
+```
+
+You'll see:
+
+```
+Current active user: John Doe <john@work.com>
+
+? Select an account to switch to:
+❯ Work (John Doe <john@work.com>)
+  Personal (Johnny <johnny@gmail.com>)
+```
+
+Select the one you want — done! Your Git user **and** SSH key are both switched instantly.
+
+---
+
+## 📖 Commands
+
+| Command | Description |
+|---|---|
+| `gitm new` | Add a new Git account with SSH key |
+| `gitm switch` | Interactively switch between saved accounts |
+| `gitm list` | Show all saved accounts + current active user |
+| `gitm remove` | Remove a saved account (optionally delete its SSH key) |
+| `gitm --help` | Show help |
+
+---
+
+## 🔧 How It Works
+
+When you run `gitm switch`, the tool does three things:
+
+```bash
+# 1. Set Git identity
+git config --global user.name "Your Name"
+git config --global user.email "your@email.com"
+
+# 2. Force Git to use the correct SSH key
+git config --global core.sshCommand "ssh -i ~/.ssh/id_ed25519_gm_work -o IdentitiesOnly=yes"
+```
+
+The `IdentitiesOnly=yes` flag is critical — it tells SSH to **only** use the specified key and ignore any other keys loaded in your SSH agent. This prevents the common problem where `git push` uses the wrong account.
+
+---
+
+## 📁 Where Data Is Stored
+
+| Path | Contents |
+|---|---|
+| `~/.config/git-manager/accounts.json` | Your saved profiles |
+| `~/.ssh/id_ed25519_gm_<profile>` | Auto-generated SSH private keys |
+| `~/.ssh/id_ed25519_gm_<profile>.pub` | Auto-generated SSH public keys |
+
+---
+
+## ❓ FAQ
+
+### Can I use an existing SSH key instead of generating a new one?
+
+Yes! When `gitm new` asks for the SSH key path, just type the full path to your existing key instead of pressing Enter:
+
+```
+? Enter SSH key path: /Users/you/.ssh/id_rsa
+```
+
+### Does this affect per-repo Git config?
+
+No. This tool only modifies `--global` Git config. If a repo has its own local `.git/config` with `user.name` / `user.email`, that will still take priority inside that repo.
+
+### What if I already have `~/.ssh/config` set up?
+
+This tool uses `core.sshCommand` which overrides `~/.ssh/config` for Git operations. Your SSH config still works for non-Git SSH connections (like `ssh myserver`).
+
+---
+
+## 🤝 Contributing
+
+PRs welcome! Feel free to open issues or submit pull requests.
+
+## 📄 License
+
+ISC

package/index.js

@@ -41,7 +41,7 @@ function getCurrentGitUser() {
 }
 
 program
-  .name('gm')
+  .name('gitm')
   .description('Git Account Manager CLI')
   .version('1.0.0');
 
@@ -51,7 +51,7 @@ program
   .action(() => {
     const accounts = loadAccounts();
     if (accounts.length === 0) {
-      console.log(chalk.yellow('No accounts found. Add one with `gm new`.'));
+      console.log(chalk.yellow('No accounts found. Add one with `gitm new`.'));
       return;
     }
     console.log(chalk.bold('\nAvailable Git Accounts:'));
@@ -141,7 +141,7 @@ program
   .action(async () => {
     const accounts = loadAccounts();
     if (accounts.length === 0) {
-      console.log(chalk.yellow('No accounts found. Add one with `gm new`.'));
+      console.log(chalk.yellow('No accounts found. Add one with `gitm new`.'));
       return;
     }
     

package/package.json

@@ -1,16 +1,26 @@
 {
   "name": "@anhducmata/git-manager",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "CLI to easily manage and switch between multiple Git accounts",
   "main": "index.js",
   "type": "module",
   "bin": {
-    "gm": "index.js"
+    "gitm": "index.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "keywords": [],
+  "keywords": [
+    "git",
+    "git-account",
+    "git-switch",
+    "ssh",
+    "ssh-key",
+    "multiple-accounts",
+    "git-manager",
+    "git-profile",
+    "cli"
+  ],
   "author": "",
   "license": "ISC",
   "dependencies": {