🎯 GHE - Beautiful GitHub Account Switcher

🚀 Quick Start

After installation, usage is simple:

# Start interactive mode
ghe

# Clone repository with account selection
ghe https://github.com/user/repo.git
ghe [email protected]:user/repo.git
ghe https://github.com/user/repo.git myproject

# Check version
ghe --version

# Get help
ghe --help

This will launch the interactive menu where you can:

1. Add your GitHub accounts (SSH keys and/or tokens)
2. Switch between accounts in any repository
3. Test connections to verify everything works
4. Manage account settings as needed

First Time Setup

1. Run ghe in your terminal
2. Choose "➕ Add account"
3. Enter your GitHub account details
4. Choose authentication method (SSH or Token)
5. Follow the prompts to configure

Switching Accounts

1. Navigate to any Git repository
2. Run ghe
3. Choose "🔄 Switch account for current repo"
4. Select your desired account
5. Done! Your repository now uses the selected account">

✨ A beautiful, interactive CLI tool for seamlessly managing multiple GitHub accounts per repository

📦 Installation

🚀 One-line Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/dwirx/ghe/main/install-curl.sh | bash

📦 Package Managers

NPM/Yarn/PNPM

npm install -g ghe
yarn global add ghe
pnpm add -g ghe

Bun (Recommended)

bun install -g ghe

🐚 Shell Compatibility: Works with bash, zsh, fish, and other POSIX-compatible shells. Automatically detects and uses the best runtime (Bun → Node.js → fallback).

🪟 Windows Support: Fully compatible with PowerShell, CMD, Git Bash, and WSL. Automatic permission handling and path normalization. See WINDOWS_SUPPORT.md for details.

Windows (PowerShell)

npm install -g ghe
# Or with Bun
bun install -g ghe

# Run Windows compatibility test
powershell -File test-windows.ps1

Homebrew (macOS/Linux)

brew tap dwirx/ghe

Arch Linux (AUR)

yay -S ghe-bin
paru -S ghe-bin

Scoop (Windows)

scoop bucket add dwirx https://github.com/dwirx/scoop-ghe
scoop install ghe

📥 Manual Download

Download pre-built binaries from GitHub Releases:

• Linux x64: ghe
• Linux ARM64: ghe-linux-arm64
• Windows x64: ghe.exe
• macOS Intel: ghe-macos
• macOS Apple Silicon: ghe-macos-arm64

# Make executable and move to PATH
chmod +x ghe
sudo mv ghe /usr/local/bin/

📋 See INSTALL.md for all installation methods and troubleshooting.

📥 Manual Download

Download pre-built binaries from GitHub Releases:

• Linux x64: ghe
• Linux ARM64: ghe-linux-arm64
• Windows x64: ghe.exe
• macOS Intel: ghe-macos
• macOS Apple Silicon: ghe-macos-arm64

# Make executable and move to PATH
chmod +x ghe
sudo mv ghe /usr/local/bin/

📋 See INSTALL.md for all installation methods and troubleshooting.

🌟 Features

• 🎨 Beautiful Terminal UI - Inspired by Charm design principles
• 🔄 Multi-Account Support - Effortlessly switch between different GitHub accounts
• 🔐 Dual Authentication - Support for both SSH keys and Personal Access Tokens
• 📁 Per-Repository Configuration - Different accounts for different repositories
• 📦 Git Clone Integration - Clone repositories directly with account selection
• 🚀 Universal Download (dl) - Download ANY file from ANY URL - Git repos OR regular URLs (NEW in v1.0.6)
• 📥 Smart Auto-Detection - Automatically detects Git repositories or regular URLs (NEW in v1.0.6)
• ⚡ Zero Dependencies - Single executable file, no runtime required
• 🎯 Interactive Interface - Intuitive prompts and visual feedback
• 🔑 SSH Key Management - Generate, import, and manage SSH keys
• 🌈 Colorful Output - Rich colors and gradients for better UX
• 🎯 Active Account Detection - See which account is currently active
• 🖥️ Cross-Platform Support - Full Windows, Linux, macOS compatibility with proper path handling
• 🎮 Built-in Lazygit - Interactive terminal UI for git operations with auto-install (NEW)
• 🔔 Automatic Update Notifications - Get notified when new versions are available (checks once per day, non-blocking)
• Generate SSH key dan Import SSH private key (auto chmod, auto .pub, auto alias/penamaan berdasarkan username).
• Test koneksi: uji SSH alias dan/atau token.

🚀 Universal Download (dl) - NEW in v1.0.6

One command for everything! Download ANY file from ANY URL - like curl and wget, but better!

Auto-Detection Magic ✨

• Git Repositories - Automatically detects GitHub, GitLab, Bitbucket URLs
• Regular URLs - Handles PDFs, ISOs, installers, media files, archives, scripts
• Smart Parsing - No need to think, just paste the URL!

All Features in One Command

• Download Anything - PDFs, ISOs, installers, media, archives, Git files
• Progress Tracking - Real-time download progress with speed indicator
• Safe Downloads - Overwrite protection, file info preview
• Batch Downloads - Multiple URLs or from file lists
• Pattern Matching - Download files matching glob patterns (Git repos only)
• Branch/Tag/Commit - Download from specific versions (Git repos only)
• Custom Headers - Add authentication, API keys, custom user agents
• Directory Download - Download entire directories from Git repos

Quick Examples

Download from any URL:

# Download a PDF
ghe dl https://example.com/document.pdf

# Download Linux ISO
ghe dl https://releases.ubuntu.com/22.04/ubuntu.iso

# Download installer
ghe dl https://omarchy.org/install -o install.sh

# Download with custom name and directory
ghe dl https://example.com/file.pdf -o my-document.pdf -d ~/Downloads/

Download from Git repositories:

# Download single file from GitHub
ghe dl https://github.com/user/repo/blob/main/README.md

# Download from different branch
ghe dl github.com/user/repo/file.md --branch develop

# Download all markdown files
ghe dl github.com/user/repo --pattern "*.md"

# Download entire directory
ghe dl-dir https://github.com/user/repo/tree/main/src

# Download latest release
ghe dl-release github.com/user/repo

Advanced usage:

# Download with authentication
ghe dl https://api.example.com/file.pdf -H "Authorization: Bearer TOKEN"

# Download multiple files
ghe dl url1 url2 url3

# Download from file list
ghe dl -f urls.txt -d ~/Downloads/

# Preview before download
ghe dl https://example.com/large-file.iso --info

Alternative Command

# ghe dlx is an alias for explicit universal download
ghe dlx <url>  # Same as 'ghe dl', works identically

📖 Documentation:

• DOWNLOAD_QUICK_START.md - Quick reference guide
• DLX_UNIVERSAL_DOWNLOAD.md - Complete universal download guide
• DOWNLOAD_FEATURE.md - Advanced Git repository features

📋 Update Notifications: GHE automatically checks for updates once per day and shows a notification when a new version is available. You can also manually check for updates from the main menu. See UPDATE_CHECKER.md for details.

🎮 Built-in Lazygit - NEW

Interactive Terminal UI for Git Operations! No installation required - GHE automatically downloads and manages lazygit for you!

✨ Auto-Install Magic

• First Run: Automatically downloads lazygit binary for your platform
• Cross-Platform: Windows, Linux (x64/ARM64), macOS (x64/ARM64)
• Cached: Downloaded once, used forever
• Fallback: Uses system lazygit if already installed
• Zero Config: Just works!

🚀 Usage

# Launch lazygit in current repository
ghe lazy

# That's it! GHE handles everything:
# ✅ Checks if you're in a git repository
# ✅ Shows your current GHE account
# ✅ Downloads lazygit if needed (first time only)
# ✅ Launches interactive terminal UI

📦 What You Get

• Interactive Staging: Visual git add/reset
• Commit Management: Easy commit, amend, reword
• Branch Operations: Create, checkout, merge, rebase
• Diff Viewer: Beautiful side-by-side diffs
• Stash Management: Visual stash operations
• Log Viewer: Interactive git log with search
• Merge Conflicts: Visual conflict resolution
• And Much More: Full git operations in TUI

🎯 Account Integration

When you run ghe lazy, it shows:

• Current GHE account in use
• Git user name and email
• Repository status

Perfect for developers who want powerful git operations without leaving the terminal!

🛠️ Development Setup

Only needed if you want to build from source:

Prasyarat

• Bun v1.0+
• Git
• OpenSSH (ssh, ssh-keygen)
• opsional: curl (untuk tes token)

Instalasi

# Clone repository
git clone https://github.com/dwirx/ghe.git
cd ghe

# Install dependencies
bun install

Development

# Run in development mode
bun run index.ts

# or
bun run start

Building Standalone Executables

# Build for current platform
bun run build

# Build for all platforms
./build.sh

# Individual platform builds
bun run build:linux     # Linux x64
bun run build:windows   # Windows x64
bun run build:macos     # macOS x64 & ARM64

Anda akan melihat menu interaktif di terminal.

🚀 Clone Repository with Account Selection

GHE dapat langsung clone repository dengan pemilihan account secara otomatis:

# Clone dengan HTTPS
ghe https://github.com/user/repo.git

# Clone dengan SSH
ghe [email protected]:user/repo.git

# Clone ke direktori tertentu
ghe https://github.com/user/repo.git myproject

# Mendukung berbagai format URL
ghe https://github.com/user/repo     # Tanpa .git
ghe [email protected]:user/repo         # SSH tanpa .git
ghe https://github.com/user/repo#    # Dengan trailing #

Cara Kerja Clone dengan Account

1. Parse URL Repository - Mendukung format SSH dan HTTPS
2. Pilih Account - Jika sudah ada account terkonfigurasi, pilih account yang akan digunakan
3. Pilih Auth Method - Jika account punya SSH dan Token, pilih method yang diinginkan
4. Setup Authentication - Otomatis setup SSH config atau token credentials
5. Clone Repository - Clone dengan URL yang sesuai method dipilih
6. Set Git Identity - Otomatis set user.name dan user.email di repo yang di-clone
7. Log Activity - Catat aktivitas clone untuk tracking

Keuntungan Clone dengan GHE

• ✅ Tidak perlu setup manual - Auth sudah di-setup sebelum clone
• ✅ Git identity otomatis - user.name dan user.email langsung ter-set
• ✅ Konsisten - Gunakan account yang sama seperti project lain
• ✅ Multi-platform - Mendukung GitHub, GitLab, Bitbucket, Gitea
• ✅ Fleksibel - Bisa pilih SSH atau HTTPS saat clone

Clone Tanpa Account

Jika belum ada account terkonfigurasi, GHE tetap bisa clone repository seperti git clone biasa:

ghe https://github.com/user/repo.git
# > No accounts configured. Cloning without account setup...
# > Proceed with clone? (Y/n)

Setelah clone, Anda bisa masuk ke direktori tersebut dan jalankan ghe untuk mengatur account.

Konsep Singkat

• Setiap “akun” menyimpan: label, user.name/user.email (opsional), konfigurasi SSH (key path + host alias), dan/atau konfigurasi Token (username + PAT).
• Konfigurasi disimpan di ~/.config/github-switch/config.json.
• Untuk SSH, tool akan menulis blok Host pada ~/.ssh/config seperti contoh:

Host github-<label>
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_<label>
  IdentitiesOnly yes

Alur Utama

1. Tambah Akun (Add account)

• Pilih metode: SSH, Token, atau keduanya.
• Isi user.name/user.email jika ingin di-set per repo saat switch.
• SSH: pilih dari daftar key yang sudah ada di ~/.ssh (auto-suggestion) atau ketik path manual; bisa generate baru jika belum ada.
• Token: isi username + Personal Access Token (PAT).

2. Import SSH Private Key (opsional, lebih mudah)

• Pilih menu “Import SSH private key”.
• Masukkan GitHub username → tool otomatis menyarankan nama file tujuan langsung di ~/.ssh, contoh: ~/.ssh/id_ed25519_<username>.
• Masukkan path private key sumber (mis. ~/.ssh/id_ed25519).
• Auto-suggestion: Anda akan mendapat daftar key yang sudah ada di ~/.ssh untuk dipilih, dan juga saran nama file tujuan yang umum dipakai.
• Pilih apakah ingin menjadikannya default untuk Host github.com (disarankan agar mudah ganti-ganti).
• Opsional: tambahkan juga alias Host khusus (mis. github-<username>), jika Anda tetap ingin alias.
• Tool akan:
  • Menyalin key ke ~/.ssh/<nama-file> dan set permission 600.
  • Membuat public key <nama-file>.pub bila belum ada (permission 644).
  • Jika dipilih, menulis/menimpa blok Host github.com agar memakai key ini.
  • Jika dipilih, menulis blok alias tambahan.
  • Opsional langsung tes koneksi SSH (ke github.com atau alias yang dipilih).

3. Switch Akun untuk Repo Saat Ini

• Jalankan tool di dalam folder repo git.
• Pilih “Switch account for current repo”, pilih akun, lalu pilih metode (SSH/Token).
• Tool akan:
  • SSH: set origin → [email protected]:owner/repo.git, atur user.name/user.email lokal repo (Host tetap github.com).
  • Token: set origin → https://github.com/owner/repo.git, atur credential.helper store dan tulis ~/.git-credentials.
  • Jika repo belum punya remote, tool akan minta input owner/repo.

4. Tes Koneksi

• Pilih “Test connection”, pilih akun, lalu pilih metode:
  • SSH: jalankan ssh -T [email protected] dan laporkan hasil.
  • Token: cek https://api.github.com/user dengan Basic Auth; sukses bila HTTP 200.

5. Switch SSH Secara Global (tetap Host github.com)

• Pilih “Switch SSH globally (Host github.com)”.
• Pilih akun (harus punya SSH key).
• Tool akan menulis/menimpa blok berikut pada ~/.ssh/config:

Host github.com
  HostName github.com
  User git
  IdentityFile /path/ke/private_key_akun
  IdentitiesOnly yes

• Dampak: semua akses [email protected]:owner/repo.git akan memakai key tersebut (tanpa ganti-ganti alias). Cocok jika ingin satu key aktif secara global dan mudah ditukar.
• Anda bisa kapan saja menjalankan menu ini lagi untuk mengganti key global.

5. Edit/Hapus/List Akun

• Edit: ubah label, user.name/user.email, aktif/nonaktif metode, ganti key path/alias atau token.
• Remove: hapus akun dari konfigurasi (tidak menghapus blok Host otomatis agar aman; bisa dihapus manual bila perlu).
• List: tampilkan ringkasan akun yang tersimpan.

Mode SSH (Detail)

• Generate Key: menu “Generate SSH key for an account”. Key dibuat dengan tipe Ed25519, tanpa passphrase (bisa Anda tambah sendiri nanti).
• Import Key: menu “Import SSH private key”.
  • Penamaan otomatis berdasarkan GitHub username untuk konsistensi.
  • Izin file di-set: private 600, public 644.
  • Alihkan host alias di ~/.ssh/config untuk memaksa key tertentu saat akses GitHub.

Mode Token (HTTPS)

• Remote di-set ke https://github.com/owner/repo.git.
• credential.helper store akan menulis token ke ~/.git-credentials dalam plaintext.
• Catatan keamanan: pertimbangkan pakai SSH bila memungkinkan guna menghindari penyimpanan token plaintext.

Tips & Praktik Terbaik

• Gunakan alias yang konsisten, mis. github-work, github-personal.
• Jika punya beberapa key, pastikan setiap repo diarahkan ke alias yang tepat.
• Untuk token, beri scope minimal yang diperlukan.

🎯 Use Cases

• Personal & Work Accounts: Keep your personal and work GitHub accounts separate
• Multiple Organizations: Switch between different organization accounts
• Client Projects: Use different accounts for different client repositories
• Open Source & Private: Different identities for public and private projects
• Quick Project Setup: Clone and setup new projects with correct account in one command
• Team Onboarding: Quickly clone multiple repos with proper authentication

🔧 Advanced Features

• SSH Key Generation: Generate Ed25519 keys directly from the CLI
• SSH Key Import: Import existing keys with automatic setup
• Global SSH Switching: Change SSH identity globally for all repositories
• Connection Testing: Verify SSH and token connectivity
• Automatic Permissions: Proper file permissions set automatically
• Cross-Platform Paths: Handles Windows, Linux, and macOS path differences

📚 Documentation

• Installation Guide - All installation methods
• Distribution Guide - For package maintainers
• Build Instructions - Building from source
• Release Process - For maintainers

🤝 Contributing

Contributions are welcome! Please check our Contributing Guidelines and feel free to:

• Report bugs by opening an issue
• Request features through discussions
• Submit pull requests with improvements

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Bun for lightning-fast performance
• UI inspired by Charm design principles
• Thanks to all contributors who help make this tool better

Made with ❤️ by bangunx

⭐ If you find GHE useful, please give it a star on GitHub!