github-switcher 0.2.0

Professional CLI tool for managing multiple GitHub identities with wizard-based profile creation and SSH key management

GitHub Switcher

Professional CLI for managing multiple GitHub identities with automated SSH key management and seamless profile switching

🎉 What's New in v0.2.0

• 🔒 Passphrase-Protected SSH Keys - Generate encrypted keys for enhanced security
• 🔍 SSH Key Fingerprinting - SHA256 fingerprints for unique identification
• 🔌 SSH Agent Integration - Intelligent detection and management
• 🛡️ Advanced Connection Testing - Comprehensive diagnostics with recovery guidance
• 📊 Enhanced Detection Command - Rich SSH environment analysis
• 🔧 Non-Destructive Operations - Preserve existing SSH setups
• 📈 Profile Metadata Tracking - Enhanced storage with security status

✨ Key Features

• 🔐 Advanced SSH Management - Generate, import, fingerprint, and manage SSH keys with passphrase support
• ⚡ Seamless Profile Switching - Switch Git identities in seconds with intelligent matching
• 🎯 Interactive Commands - Smart wizards with case-insensitive profile matching and rich feedback
• 🔍 Intelligent SSH Detection - Auto-detect existing setup with deduplication and ssh-agent integration
• 🛡️ Enterprise Security - Passphrase-protected keys, ssh-agent integration, comprehensive connection testing
• 🌐 Cross-Platform - Enhanced support for macOS, Linux, and Windows with improved configuration handling
• 🏢 Production-Ready - 320+ tests, 89%+ coverage, type-safe, professionally maintained

📦 Installation

Recommended: UV (Modern & Fast)

UV is a modern, fast Python package and project manager written in Rust. It's 10-100x faster than pip and provides better dependency resolution.

First, install UV if you don't have it:

macOS:

brew install uv

Linux/WSL:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Alternative (any platform):

pip install uv

Then install GitHub Switcher:

uv tool install github-switcher

UV provides faster installation (10x+ faster), better dependency resolution, and isolated tool management

Standard: pip

pip install github-switcher

macOS/Linux: Homebrew

brew tap mostafagamil/github-switcher
brew install github-switcher

🔧 System Requirements

• Python 3.10+ - Modern Python runtime
• Git - Required for SSH operations and profile management
  • macOS: xcode-select --install or brew install git
  • Windows: Git for Windows (includes Git Bash)
  • Linux: Usually pre-installed (sudo apt install git if needed)
• SSH client - For secure GitHub connectivity (included with Git)

🚀 Quick Start

# Verify installation
ghsw --version

# Create your first profile (interactive wizard)
ghsw create

# List all profiles
ghsw list

# Switch between profiles
ghsw switch work
ghsw switch personal

# Test SSH connection
ghsw test work

💻 Interactive Commands

All commands support interactive mode when no arguments are provided:

# Interactive profile creation - detects existing SSH keys
ghsw create

# Interactive switching - shows numbered profile list
ghsw switch
# 🔧 Select a profile to switch to:
#   1. work - [e-mail] 🟢 Active
#   2. personal - [e-mail] ⚪ Inactive
# 🎯 Enter profile number or name: 2

# Interactive profile management
ghsw delete          # Choose from list
ghsw copy-key        # Copy SSH public key to clipboard
ghsw test            # Test GitHub connection
ghsw regenerate-key  # Generate new SSH key

🔒 Enhanced Security Features (v0.2.0)

Passphrase-Protected SSH Keys: Generate and manage encrypted SSH keys for enhanced security:

ghsw regenerate-key work
# 🔐 Generate passphrase-protected key? [Y/n]: Y
# 🔑 Enter passphrase for new SSH key: ••••••••
# ✅ New encrypted SSH key generated!

SSH Key Fingerprinting: Every key gets a unique SHA256 fingerprint for identification:

ghsw list
# 📋 GitHub Profiles:
#   🟢 work - [e-mail] (Active)
#       🔐 SSH: Protected • SHA256:abc123def456... • Ed25519
#   ⚪ personal - [e-mail] 
#       🔓 SSH: Unprotected • SHA256:def456abc123... • Ed25519

SSH Agent Integration: Intelligent detection and management of loaded keys:

ghsw detect
# 🔌 SSH Agent Status:
#   ✅ ssh-agent running (PID: 12345)
#   🔑 2/4 keys loaded in agent
#   🔐 1 passphrase-protected key requires unlock

🔍 Advanced SSH Intelligence

GitHub Switcher provides enterprise-grade SSH key management with comprehensive analysis:

ghsw detect
# 🔍 Analyzing SSH environment...
# 📊 SSH Key Analysis:
#   🔑 Total keys found: 4
#   ✅ Ed25519 keys: 2 (recommended)
#   🔐 Passphrase-protected: 1
#   🔓 Unencrypted: 3
# 🏷️ Profile Associations:
#   ✅ work → id_ed25519_work (SHA256:abc123...)
#   ✅ personal → id_ed25519_personal (SHA256:def456...)
# 🔌 SSH Agent Status:
#   ✅ ssh-agent running
#   🔑 2 keys loaded in agent
# 🌐 GitHub Connectivity: ✅ All connections optimal

Enterprise SSH Features (v0.2.0):

• 🔐 Passphrase Protection - Generate and detect encrypted SSH keys for enhanced security
• 🔍 Key Fingerprinting - SHA256 fingerprints for unique identification and deduplication
• 🔌 SSH Agent Integration - Intelligent detection and management of ssh-agent loaded keys
• 🛡️ Advanced Connection Testing - Comprehensive diagnostics with specific error guidance and recovery suggestions
• 🔧 Non-Destructive Operations - Copy (don't move) existing keys, preserve original setup
• 📈 Profile Metadata Tracking - Enhanced profile storage with SSH key attributes and usage history
• 🛠️ Enhanced Detection Command - Rich SSH environment analysis with security insights and key metadata

📋 Command Reference

Command	Description
ghsw create [options]	Create new profile with interactive wizard
ghsw list	Show all profiles with SSH security status and activity
ghsw switch [profile]	Switch to profile (interactive if no argument)
ghsw current	Display currently active profile
ghsw delete [profile]	Remove profile and clean up SSH keys
ghsw copy-key [profile]	Copy SSH public key to clipboard
ghsw test [profile]	Test SSH connection to GitHub
ghsw regenerate-key [profile]	Generate new SSH key with passphrase protection (v0.2.0)
ghsw detect	Comprehensive SSH environment analysis with security insights

🏢 Enterprise Features

• 🔒 Advanced Security (v0.2.0) - Passphrase-protected keys, SHA256 fingerprinting, ssh-agent integration, secure defaults
• Comprehensive Testing - 320+ tests with 89%+ coverage ensuring reliability across all platforms
• Intelligent Error Handling - Robust error recovery with specific guidance for SSH issues
• Cross-Platform Excellence - Automated testing on macOS, Linux, and Windows with platform optimizations
• Type Safety - Full type hints and static analysis validation with mypy
• Enterprise Documentation - Complete guides covering advanced SSH features and security practices

📖 Documentation

• Installation Guide - Comprehensive setup instructions
• Usage Guide - Complete feature documentation
• Advanced SSH Management - Comprehensive SSH key features including passphrase protection and ssh-agent integration
• API Reference - Programmatic usage
• Contributing - Development and contribution guidelines
• Security Policy - Vulnerability reporting and security practices

🤝 Support & Contributing

• Issues & Bug Reports - GitHub Issues
• Feature Requests - GitHub Discussions
• Contributing - See Contributing Guidelines
• Security - See Security Policy

💡 Example Workflows

Development Teams

# Set up work and personal profiles
ghsw create --name work --fullname "John Doe" --email [e-mail]
ghsw create --name personal --fullname "John Doe" --email [e-mail]

# Switch contexts quickly
ghsw switch work      # Work on company projects
ghsw switch personal  # Contribute to open source

Freelancers

# Manage multiple clients
ghsw create --name client-a --email [e-mail]
ghsw create --name client-b --email [e-mail]
ghsw create --name personal --email [e-mail]

# Quick client switching
ghsw switch client-a  # Work on Client A projects
ghsw switch client-b  # Switch to Client B work

📊 Quality Metrics

• Test Coverage - Enterprise-grade test suite with 320+ tests and 89%+ coverage
• Cross-Platform - Automated CI testing on macOS, Linux, Windows with performance optimization
• Type Safety - Full mypy validation with strict settings and comprehensive type coverage
• Code Quality - Linted with ruff, formatted consistently, maintained to professional standards
• Security (v0.2.0) - Passphrase-protected Ed25519 keys, SHA256 fingerprinting, ssh-agent integration, proper permissions

🌟 Support the Project

If GitHub Switcher helps improve your workflow, consider supporting its development:

Your support helps maintain and enhance GitHub Switcher with new features and improvements!

📄 License

MIT License - see LICENSE for details.

---

Made with ❤️ for developers managing multiple GitHub identities