#!/bin/sh

#================================================================#

# GITSSH v0.1.0 - Git SSH User Session Manager CLI

# Clean command dispatcher without backward compatibility

#================================================================#

set -e

# Version information

readonly GITSSH_VERSION="0.1.0"

readonly GITSSH_NAME="GitSSH"

#================================================================#

# SCRIPT LOCATION DETECTION

#================================================================#

if [ -n "${BASH_SOURCE:-}" ]; then

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

else

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"

fi

# Determine modules directory based on installation structure

MODULES_DIR=""

# Check if we're running from the symlink location

if [ -L "$0" ]; then

# Follow symlink to actual executable location

REAL_SCRIPT="$(readlink "$0")"

if [ "${REAL_SCRIPT#/}" = "$REAL_SCRIPT" ]; then

# Relative path, resolve it

REAL_SCRIPT="$(cd "$(dirname "$0")" && cd "$(dirname "$REAL_SCRIPT")" && pwd)/$(basename "$REAL_SCRIPT")"

fi

SCRIPT_DIR="$(dirname "$REAL_SCRIPT")"

fi

# Look for modules in the modules/ subdirectory

if [ -f "$SCRIPT_DIR/modules/gitssh-utils.sh" ]; then

MODULES_DIR="$SCRIPT_DIR/modules"

elif [ -f "$SCRIPT_DIR/gitssh-utils.sh" ]; then

# Fallback: modules in same directory as script

MODULES_DIR="$SCRIPT_DIR"

elif [ -f "$HOME/.local/bin/gitssh-libs/modules/gitssh-utils.sh" ]; then

# Standard user installation

MODULES_DIR="$HOME/.local/bin/gitssh-libs/modules"

elif [ -f "/usr/local/lib/gitssh/modules/gitssh-utils.sh" ]; then

# System-wide installation

MODULES_DIR="/usr/local/lib/gitssh/modules"

else

printf "Error: Cannot locate GitSSH modules\n" >&2

printf "Searched locations:\n" >&2

printf " - %s/modules/gitssh-utils.sh\n" "$SCRIPT_DIR" >&2

printf " - %s/gitssh-utils.sh\n" "$SCRIPT_DIR" >&2

printf " - %s/.local/bin/gitssh-libs/modules/gitssh-utils.sh\n" "$HOME" >&2

printf " - /usr/local/lib/gitssh/modules/gitssh-utils.sh\n" >&2

exit 1

fi

#================================================================#

# CONFIGURATION

#================================================================#

readonly GIT_SSH_CONFIG_FILE="${GIT_SSH_CONFIG_FILE:-$HOME/.gitssh-sessions.json}"

readonly GIT_SSH_USERS_FILE="${GIT_SSH_USERS_FILE:-$HOME/.gitssh-users.json}"

readonly GIT_SESSION_TEMP="/tmp/gitssh-session-$$"

export GIT_SSH_CONFIG_FILE GIT_SSH_USERS_FILE GIT_SESSION_TEMP SCRIPT_DIR

#================================================================#

# MODULE LOADING

#================================================================#

_load_modules() {

local modules="utils init users sessions remotes commands setup"

local loaded_count=0

local failed_modules=""

for module in $modules; do

module_file="$MODULES_DIR/gitssh-${module}.sh"

if [ -f "$module_file" ]; then

if . "$module_file" 2>/dev/null; then

loaded_count=$((loaded_count + 1))

else

failed_modules="$failed_modules gitssh-${module}.sh"

printf "Error: Failed to load module: gitssh-%s.sh\n" "$module" >&2

fi

else

failed_modules="$failed_modules gitssh-${module}.sh"

printf "Error: Required module not found: gitssh-%s.sh\n" "$module" >&2

printf "Expected location: %s\n" "$module_file" >&2

fi

done

if [ "$loaded_count" -lt 7 ]; then

printf "Error: Only %d of 7 required modules loaded\n" "$loaded_count" >&2

if [ -n "$failed_modules" ]; then

printf "Failed modules:%s\n" "$failed_modules" >&2

fi

printf "Modules directory: %s\n" "$MODULES_DIR" >&2

exit 1

fi

# Optional: Print success message for debugging

# printf "Successfully loaded %d GitSSH modules from: %s\n" "$loaded_count" "$MODULES_DIR" >&2

}

#================================================================#

# COMMAND HANDLERS

#================================================================#

_handle_user_commands() {

subcommand="$1"

shift

case "$subcommand" in

add)

user_add "$@"

;;

remove|rm|delete)

user_remove "$@"

;;

list|ls)

user_list "$@"

;;

status|show|info)

user_status "$@"

;;

switch)

if [ $# -eq 0 ]; then

printf "Error: Username required\n" >&2

printf "Usage: gitssh user switch <username>\n" >&2

printf " gitssh user switch -g <username>\n" >&2

user_list --simple | sed 's/^/ /'

return 1

fi

case "$1" in

-g|--global)

shift

if [ $# -eq 0 ]; then

printf "Error: Username required after %s flag\n" "$1" >&2

return 1

fi

user_switch -g "$@"

;;

*)

user_switch "$@"

;;

esac

;;

edit)

user_edit "$@"

;;

*)

printf "Error: Unknown user command '%s'\n" "$subcommand" >&2

_show_user_help

return 1

;;

esac

}

_handle_session_commands() {

subcommand="$1"

shift

case "$subcommand" in

set|config|configure)

session_set "$@"

;;

show|status|info)

session_show "$@"

;;

clear|reset)

session_clear "$@"

;;

forget|remove)

session_forget "$@"

;;

list|ls)

session_list "$@"

;;

cleanup|clean)

session_cleanup "$@"

;;

export)

session_export "$@"

;;

import)

session_import "$@"

;;

*)

printf "Error: Unknown session command '%s'\n" "$subcommand" >&2

_show_session_help

return 1

;;

esac

}

_handle_ssh_commands() {

subcommand="$1"

shift

case "$subcommand" in

status|info)

ssh_status "$@"

;;

doctor|diagnose)

ssh_doctor "$@"

;;

repair|fix)

ssh_repair "$@"

;;

test)

if [ $# -eq 0 ]; then

printf "Error: SSH host required\n" >&2

printf "Usage: gitssh ssh test <hostname>\n" >&2

return 1

fi

ssh_test "$@"

;;

backup)

ssh_backup "$@"

;;

restore)

ssh_restore "$@"

;;

learn|help)

ssh_learn "$@"

;;

*)

printf "Error: Unknown ssh command '%s'\n" "$subcommand" >&2

_show_ssh_help

return 1

;;

esac

}

_handle_remote_commands() {

subcommand="$1"

shift

case "$subcommand" in

convert|ssh)

remote_convert "$@"

;;

add)

if [ $# -lt 2 ]; then

printf "Error: Remote name and URL required\n" >&2

printf "Usage: gitssh remote add <name> <url>\n" >&2

return 1

fi

remote_add "$@"

;;

check|analyze)

remote_check "$@"

;;

list|ls)

remote_list "$@"

;;

recommendations|recommend)

remote_recommendations "$@"

;;

*)

printf "Error: Unknown remote command '%s'\n" "$subcommand" >&2

_show_remote_help

return 1

;;

esac

}

_handle_git_commands() {

subcommand="$1"

shift

case "$subcommand" in

clone)

git_clone "$@"

;;

status|st)

git_status "$@"

;;

info|analyze)

git_info "$@"

;;

commit|ci)

git_commit "$@"

;;

push)

git_push "$@"

;;

pull)

git_pull "$@"

;;

fetch)

git_fetch "$@"

;;

init)

git_init "$@"

;;

*)

printf "Error: Unknown git command '%s'\n" "$subcommand" >&2

_show_git_help

return 1

;;

esac

}

_handle_setup_commands() {

subcommand="$1"

shift

case "$subcommand" in

github)

setup_github "$@"

;;

gitlab)

setup_gitlab "$@"

;;

*)

printf "Error: Unknown setup target '%s'\n" "$subcommand" >&2

_show_setup_help

return 1

;;

esac

}

_handle_config_commands() {

subcommand="$1"

shift

case "$subcommand" in

show|info)

config_show "$@"

;;

reset)

config_reset "$@"

;;

backup)

config_backup "$@"

;;

restore)

if [ $# -eq 0 ]; then

printf "Error: Backup path required\n" >&2

printf "Usage: gitssh config restore <backup-path>\n" >&2

return 1

fi

config_restore "$@"

;;

migrate)

config_migrate "$@"

;;

*)

printf "Error: Unknown config command '%s'\n" "$subcommand" >&2

_show_config_help

return 1

;;

esac

}

#================================================================#

# INSTALLATION COMMAND HANDLERS

#================================================================#

_handle_install_commands() {

subcommand="$1"

shift

# Find the installer script

installer_script=""

# Check common locations for installer

if [ -f "$SCRIPT_DIR/install" ]; then

installer_script="$SCRIPT_DIR/install"

elif [ -f "$INSTALL_DIR/install" ]; then

installer_script="$INSTALL_DIR/install"

elif [ -f "$(dirname "$0")/install" ]; then

installer_script="$(dirname "$0")/install"

else

printf "Error: Installer script not found\n" >&2

printf "Looked in:\n" >&2

printf " - %s/install\n" "$SCRIPT_DIR" >&2

printf " - %s/install\n" "$INSTALL_DIR" >&2

printf " - %s/install\n" "$(dirname "$0")" >&2

return 1

fi

# Make sure installer is executable

if [ ! -x "$installer_script" ]; then

chmod +x "$installer_script" 2>/dev/null || {

printf "Error: Cannot execute installer script: %s\n" "$installer_script" >&2

return 1

}

fi

case "$subcommand" in

install|reinstall)

printf "Running GitSSH installer...\n"

exec "$installer_script" install "$@"

;;

uninstall|remove)

printf "Running GitSSH uninstaller...\n"

exec "$installer_script" uninstall "$@"

;;

update|upgrade)

printf "Running GitSSH updater...\n"

exec "$installer_script" update "$@"

;;

verify|test-install)

printf "Verifying GitSSH installation...\n"

exec "$installer_script" verify "$@"

;;

diagnose|doctor-install)

printf "Running installation diagnostics...\n"

exec "$installer_script" diagnose "$@"

;;

*)

printf "Error: Unknown install command '%s'\n" "$subcommand" >&2

_show_install_help

return 1

;;

esac

}

_show_install_help() {

cat << 'EOF'

INSTALLATION MANAGEMENT:

gitssh install install Reinstall GitSSH system

gitssh install uninstall Completely remove GitSSH

gitssh install update Update to latest version

gitssh install verify Verify installation integrity

gitssh install diagnose Run installation diagnostics

INSTALLATION SHORTCUTS (aliases):

gitssh reinstall Same as 'install install'

gitssh uninstall Same as 'install uninstall'

gitssh update Same as 'install update'

gitssh verify Same as 'install verify'

gitssh diagnose Same as 'install diagnose'

EXAMPLES:

gitssh verify # Check if installation is healthy

gitssh update # Update GitSSH installation

gitssh uninstall # Remove GitSSH completely

gitssh install verify # Alternative full syntax

EOF

}

#================================================================#

# HELP FUNCTIONS

#================================================================#

_show_main_help() {

cat << 'EOF'

╔═══════════════════════════════════════════════════════════════╗

║ ║

║ ██████╗ ███████╗███████╗██╗ ██╗ ║

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

║ ██║ ███╗══╝████║███████╗███████╗███████║ ║

║ ██║ ██║██║ ██║ ╚════██║╚════██║██╔══██║ ║

║ ██████╔╝██║ ██║ ███████║███████║██║ ██║ ║

║ ╚═════╝ ╚═╝ ╚═╝ ╚══════╝╚══════╝╚═╝ ╚═╝v0.1.0-Oz ║

║ <-POSIX Compliant-> ║

║ ║

╚═══════════════════════════════════════════════════════════════╝

Manage Multiple SSH Git and GitHub Account Sessions With Ease!

USAGE:

gitssh <command> [subcommand] [options]

SETUP & INITIALIZATION:

init Initialize GitSSH configuration

onboard|setup-wizard Interactive first-time setup wizard

validate|check|doctor Validate gitssh system configuration

ENHANCED GIT OPERATIONS:

clone <url> Enhanced git clone with auto-setup

status|st Enhanced git status with user info

commit|ci [opts] Enhanced git commit with user verification

push [opts] Enhanced git push with verification

fetch [opts] Enhanced git fetch with SSH verification

pull [opts] Enhanced git pull with SSH verification

info Show detailed repository information and SSH connection

USER MANAGEMENT:

switch|sw <user> Switch to user locally

switch|sw -g <user> Switch to user globally

user|users See user accounts and ssh accounts status

user add [opts] Add new user account

user remove|rm|delete <user> Remove user account

user list List all configured users

user switch <user> Switch to user locally

user switch -g <user> Switch to user globally

user status Show current user status

SESSION MANAGEMENT:

session|sess Show current repository and user session information

session set Set user for current repository

session status [options]Show current repository and user session information

session show [options] Show current repository and user session information

session clear Clear session data

session forget|remove Remove persistent config for repo

session list List all session repositories

session export <path> Export session data to file

session import <path> Import session data from file

session cleanup Cleanup stale session data

SSH MANAGEMENT:

ssh status|info Show SSH configuration status

ssh doctor Diagnose SSH connection issues

ssh repair Fix common SSH problems

ssh test <host> Test SSH connection

ssh backup Backup SSH configuration

ssh restore <path> Restore SSH configuration from backup

ssh learn Guide to adding new SSH hosts

SETUP WIZARDS:

setup github Setup GitHub SSH authentication

setup gitlab Setup GitLab SSH authentication

REMOTE MANAGEMENT:

remote|remotes Show git repository remotes

remote convert Convert HTTPS remote to SSH

remote add <name> <url> Add remote with SSH conversion

remote check Check remote configuration

remote list List all remotes with details

remote recommendations Show remote configuration recommendations

CONFIGURATION:

config show Show current configuration

config reset Reset configuration to defaults

config backup Backup configuration files

config restore <path> Restore from backup

config migrate Migrate from old configuration format

INSTALLATION/UNINSTALLATION/UPDATE MANAGEMENT:

gitssh reinstall Reinstall GitSSH system

gitssh uninstall|remove Completely remove GitSSH

gitssh update|upgrade Update to latest version

gitssh verify|test-install Verify installation integrity

gitssh diagnose|doctor-install Run installation diagnostics

INFORMATION:

help [command] Show help (general or command-specific)

version Show version information

EXAMPLES:

gitssh onboard # First-time setup

gitssh user add # Add new user

gitssh user switch work # Switch to work identity

gitssh session set # Configure current repo

gitssh clone github.com/user/repo.git

gitssh remote convert # Convert HTTPS to SSH

gitssh ssh status # Check SSH setup

EOF

}

_show_user_help() {

cat << 'EOF'

USER MANAGEMENT:

gitssh user add [options]

Add new user account interactively

Options:

--name <name> Full display name

--email <email> Email address

--ssh-host <host> SSH hostname

gitssh user remove [username]

Remove user account with confirmation

gitssh user list [options]

List all configured users

Options:

--simple Simple list for scripting

gitssh user switch <username>

Switch to specified user locally

gitssh user switch -g <username>

Switch to specified user globally

gitssh user status

Show current Git user and SSH status

EXAMPLES:

gitssh user add

gitssh user add --name "John Doe" --email "[email protected]"

gitssh user list

gitssh user switch work

gitssh user remove old-account

EOF

}

_show_session_help() {

cat << 'EOF'

SESSION MANAGEMENT:

gitssh session

Show current repository session information

gitssh session set [options]

Set user for current repository

Options:

--user <username> Set specific user

gitssh session show [options], gitssh session status [options]

Show current session status

Options:

--verbose Show detailed information

gitssh session clear

Clear all session data (temporary mappings)

gitssh session forget

Remove persistent configuration for current repository

gitssh session list

List all repositories in current session

EXAMPLES:

gitssh session

gitssh session status

gitssh session status --verbose

gitssh session set

gitssh session set --user work

gitssh session show

gitssh session show --verbose

gitssh session clear

EOF

}

_show_ssh_help() {

cat << 'EOF'

SSH MANAGEMENT:

gitssh ssh status

Show comprehensive SSH configuration status

gitssh ssh doctor

Diagnose SSH connection issues and problems

gitssh ssh repair

Automatically fix common SSH problems

gitssh ssh test <hostname>

Test SSH connection to specific host

gitssh ssh backup

Create backup of SSH configuration

gitssh ssh restore <path>

Restore SSH configuration from backup

EXAMPLES:

gitssh ssh status

gitssh ssh doctor

gitssh ssh test github-work

gitssh ssh repair

EOF

}

_show_remote_help() {

cat << 'EOF'

REMOTE MANAGEMENT:

gitssh remote convert

Convert HTTPS remote to SSH for current repository

gitssh remote add <name> <url>

Add new remote with SSH conversion

gitssh remote check

Analyze current remote configuration

gitssh remote list

Show all remotes with detailed information

EXAMPLES:

gitssh remote convert

gitssh remote add upstream [email protected]:upstream/repo.git

gitssh remote check

gitssh remote list

EOF

}

_show_git_help() {

cat << 'EOF'

ENHANCED GIT OPERATIONS:

gitssh clone <url> [directory]

Enhanced git clone with automatic user setup

gitssh status

Enhanced git status with user and remote information

gitssh info

Show detailed repository information and analysis

gitssh commit [options]

Enhanced git commit with user verification

gitssh push [options]

Enhanced git push with SSH testing and verification

EXAMPLES:

gitssh clone [email protected]:user/repo.git

gitssh status

gitssh commit -m "Update feature"

gitssh push origin main

EOF

}

_show_setup_help() {

cat << 'EOF'

SETUP WIZARDS:

gitssh setup github

Interactive GitHub SSH key setup wizard

- Generates SSH keys

- Configures SSH hosts

- Guides through GitHub key addition

- Tests connectivity

gitssh setup gitlab

Interactive GitLab SSH key setup wizard

- Supports GitLab.com and self-hosted instances

- Complete SSH configuration

- Connection testing

EXAMPLES:

gitssh setup github

gitssh setup gitlab

EOF

}

_show_config_help() {

cat << 'EOF'

CONFIGURATION MANAGEMENT:

gitssh config show

Show current system configuration and status

gitssh config reset

Reset all configuration to defaults (destructive)

gitssh config backup

Create timestamped backup of all configuration

gitssh config restore <path>

Restore configuration from backup directory

gitssh config migrate

Migrate from old configuration format

EXAMPLES:

gitssh config show

gitssh config backup

gitssh config restore ~/gitssh-backup-20250101

EOF

}

_show_command_help() {

command="$1"

case "$command" in

user) _show_user_help ;;

session) _show_session_help ;;

ssh) _show_ssh_help ;;

remote) _show_remote_help ;;

git) _show_git_help ;;

setup) _show_setup_help ;;

config) _show_config_help ;;

*) _show_main_help ;;

esac

}

#================================================================#

# GLOBAL OPTIONS PARSING

#================================================================#

_parse_global_options() {

GITSSH_VERBOSE=false

GITSSH_QUIET=false

GITSSH_FORCE=false

while [ $# -gt 0 ]; do

case "$1" in

--verbose|-v)

GITSSH_VERBOSE=true

export GITSSH_VERBOSE

shift

;;

--quiet|-q)

GITSSH_QUIET=true

export GITSSH_QUIET

shift

;;

--force|-f)

GITSSH_FORCE=true

export GITSSH_FORCE

shift

;;

--help|-h)

_show_main_help

exit 0

;;

--version)

printf "%s v%s\n" "$GITSSH_NAME" "$GITSSH_VERSION"

exit 0

;;

--)

shift

break

;;

-*)

printf "Error: Unknown global option '%s'\n" "$1" >&2

printf "Use 'gitssh --help' for usage information\n" >&2

exit 1

;;

*)

break

;;

esac

done

}

#================================================================#

# MAIN COMMAND ROUTER

#================================================================#

_route_command() {

if [ $# -eq 0 ]; then

_show_main_help

return 0

fi

command="$1"

shift

# Handle help requests for any command

case "${1:-}" in

--help|-h|help)

_show_command_help "$command"

return 0

;;

esac

case "$command" in

# Setup and initialization

init|initialize)

system_init "$@"

;;

onboard|setup-wizard)

system_onboard "$@"

;;

validate|check|doctor)

system_validate "$@"

;;

setup)

if [ $# -eq 0 ]; then

printf "Error: Setup target required\n" >&2

_show_setup_help

return 1

fi

_handle_setup_commands "$@"

;;

# User management

user|users)

if [ $# -eq 0 ]; then

user_status

else

_handle_user_commands "$@"

fi

;;

# Session management

session|sess)

if [ $# -eq 0 ]; then

session_show

else

_handle_session_commands "$@"

fi

;;

# SSH management

ssh)

if [ $# -eq 0 ]; then

ssh_status

else

_handle_ssh_commands "$@"

fi

;;

# Remote management

remote|remotes)

if [ $# -eq 0 ]; then

remote_list

else

_handle_remote_commands "$@"

fi

;;

# Git operations (direct commands)

clone)

if [ $# -eq 0 ]; then

printf "Error: Repository URL required\n" >&2

printf "Usage: gitssh clone <url> [directory]\n" >&2

return 1

fi

git_clone "$@"

;;

status|st)

git_status "$@"

;;

info|analyze)

git_info "$@"

;;

commit|ci)

git_commit "$@"

;;

push)

git_push "$@"

;;

pull)

git_pull "$@"

;;

fetch)

git_fetch "$@"

;;

# Configuration management

config|configuration)

if [ $# -eq 0 ]; then

config_show

else

_handle_config_commands "$@"

fi

;;

# Global user switching (shortcut)

switch|sw)

if [ $# -eq 0 ]; then

printf "Error: Username required\n" >&2

printf "Usage: gitssh switch <username>\n" >&2

user_list_simple

return 1

fi

user_switch "$@"

;;

# Information

help|--help|-h)

if [ $# -gt 0 ]; then

_show_command_help "$1"

else

_show_main_help

fi

;;

version|--version|-v)

printf "%s v%s\n" "$GITSSH_NAME" "$GITSSH_VERSION"

;;

# Installation management

install)

if [ $# -eq 0 ]; then

printf "Error: Install command required\n" >&2

_show_install_help

return 1

fi

_handle_install_commands "$@"

;;

# Direct aliases for installation commands (without "install" prefix)

reinstall)

_handle_install_commands "install" "$@"

;;

uninstall|remove)

_handle_install_commands "uninstall" "$@"

;;

update|upgrade)

_handle_install_commands "update" "$@"

;;

verify|test-install)

_handle_install_commands "verify" "$@"

;;

diagnose|doctor-install)

_handle_install_commands "diagnose" "$@"