🇪🇸 Leer en español

  ██████╗  █████╗ ███╗   ███╗
 ██╔════╝ ██╔══██╗████╗ ████║
 ██║  ███╗███████║██╔████╔██║
 ██║   ██║██╔══██║██║╚██╔╝██║
 ╚██████╔╝██║  ██║██║ ╚═╝ ██║
  ╚═════╝ ╚═╝  ╚═╝╚═╝     ╚═╝

🔑 Git Account Manager

Manage multiple GitHub accounts with SSH from the terminal — no manual config, no passwords, no drama.

---

🤔 Why GAM?

Got a personal and a work GitHub account on the same machine? Without GAM you have to manually edit ~/.ssh/config, generate SSH keys, set up ~/.gitconfig, and pray you don't push to the wrong repo with the wrong account.

GAM fixes that with a single command:

Without GAM 😩	With GAM 😎
Manually edit ~/.ssh/config	gam add
Remember which SSH key to use	Automatic per folder
Change user.email before every commit	gam switch work
Clone with the right SSH URL	gam clone work company/repo
Lose your config when you format	gam export > backup.txt

---

✨ Demo

$ gam list
╔══════════════════════════════════════════╗
║   🔑  Cuentas de GitHub configuradas   ║
╚══════════════════════════════════════════╝

  📁 personal
  ├─ 🔑  github.com-personal
  └─ 👤  John Doe <john@personal.com>

  📁 work
  ├─ 🔑  github.com-work
  └─ 👤  John Doe <john@company.com>

  ──────────────────────────────────────────
  Total: 2 account(s)

$ gam test work
[INFO] Probando conexión para work...
[✓] Conexión exitosa para work

$ gam clone work company/project
[INFO] Clonando company/project con cuenta work...
[✓] Repositorio clonado exitosamente

---

📦 Requirements

• 🐧 Linux: Ubuntu 20.04+, Debian 11+ (or any distro with bash 4+)
• 🍎 macOS: 12 Monterey or later
• 🔧 git
• 🔐 openssh-client

---

🚀 Installation

One-liner (downloads and installs automatically):

bash <(curl -fsSL https://raw.githubusercontent.com/lacasoft/git-account-manager/main/install.sh)

From the repo (if you prefer to review the code first):

git clone https://github.com/lacasoft/git-account-manager.git
cd git-account-manager
bash install.sh

Installs gam to /usr/local/bin/, deploys libraries to ~/.gam/, and sets up shell autocompletion.

macOS: GAM auto-detects your system and configures ssh-add --apple-use-keychain, UseKeychain in SSH config, and uses pbcopy to copy keys to the clipboard.

---

⚡ Quick start

gam add                          # ➕ Add account (interactive)
gam list                         # 📋 List all accounts
gam test personal                # 🔌 Test SSH connection
gam clone personal lacasoft/repo # 📥 Clone with specific account
gam use ~/code/work              # 📂 Auto-configure Git per folder
gam switch work                  # 🔄 Switch global Git config
gam export > backup.txt          # 💾 Export configuration
gam import backup.txt            # 📤 Restore configuration

---

📖 Commands

Command	Syntax	Description
add	gam add [--name X --email X --username X]	➕ Add new account
list	gam list	📋 List configured accounts
remove	gam remove <account>	🗑️ Remove account and its keys
test	gam test [account]	🔌 Test SSH connection
clone	gam clone <account> <user/repo>	📥 Clone repo with specific account
switch	gam switch <account>	🔄 Switch global Git config
use	gam use <folder>	📂 Auto-configure Git per folder
export	gam export	💾 Export configuration
import	gam import <file>	📤 Restore configuration

---

🧠 How it works

GAM uses custom SSH hosts to separate accounts:

# ~/.ssh/config generated by GAM
Host github.com-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal

Host github.com-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work

And Git's includeIf directive to apply the right profile per folder:

# ~/.gitconfig
[includeIf "gitdir:~/code/personal/"]
    path = ~/.gitconfig-personal

[includeIf "gitdir:~/code/work/"]
    path = ~/.gitconfig-work

💡 Each repository automatically uses the correct name, email, and SSH key — no extra configuration needed.

---

🔄 gam add flow

gam add
  │
  ├─ 📝  Prompts for account name, email, and GitHub username
  ├─ 🔐  Generates Ed25519 SSH key → ~/.ssh/id_ed25519_{account}
  ├─ 🤝  Adds the key to the SSH agent
  ├─ ⚙️  Appends Host block to ~/.ssh/config
  ├─ 📋  Shows public key → paste it in GitHub Settings > SSH Keys
  ├─ ✅  Verifies connection with ssh -T github.com-{account}
  └─ 📂  Configures automatic Git profile per folder (optional)

---

📁 Generated files

~/.ssh/id_ed25519_{account}       # 🔑 SSH private key
~/.ssh/id_ed25519_{account}.pub   # 📋 SSH public key
~/.ssh/config                     # ⚙️  SSH config per account
~/.gitconfig-{account}            # 👤 Git profile for the account
~/.gitconfig                      # 🗂️  includeIf entries per folder
~/.gam/                           # 📦 GAM libraries and templates

---

🗑️ Uninstall

bash uninstall.sh

Prompts whether to also remove SSH keys and Git configurations generated by GAM.

---

🤝 Contributing

Want to improve GAM? Read CONTRIBUTING.md for local development instructions, conventions, and how to open a PR.

Found a bug? Open an issue.

---

📄 License

MIT © lacasoft — use it, modify it, share it.