Skip to content

Releases: user-cube/gclone

v1.0.0

10 May 18:15
0df7d7a

Choose a tag to compare

GClone v1.0.0 Release Notes

Released: May 10, 2025

GClone is a powerful Git repository management tool designed for developers who work with multiple Git accounts. It allows you to define different profiles (personal, work, etc.) and automatically applies the correct SSH and Git configurations when cloning repositories.

Core Features

Profile System

  • Create unlimited profiles for different contexts (personal, work, client projects)
  • Each profile can have its own:
    • SSH host configuration
    • Git user settings (name, email)
    • Custom Git configurations
    • URL patterns for automatic detection

Git Operations

  • Clone repositories with the correct identity automatically applied
  • Transforms repository URLs to use profile-specific SSH hosts
  • Applies Git configurations to newly cloned repositories
  • Supports common Git clone parameters (depth, branch, etc.)

SSH Management

  • ssh-config command automates SSH configuration setup
  • Creates a dedicated config file for GClone SSH settings
  • Integrates with your main SSH config through Include directives
  • Guides you through SSH key creation and setup

Command Suite

  • init - Create default configuration and profiles
  • profile - Manage profiles (add, remove, list)
  • clone - Clone repositories with profile awareness
  • config - Display current configuration
  • ssh-config - Manage SSH configurations
  • version - Display version information

Getting Started

After installation, initialize GClone with:

gclone init

This creates a configuration with sample profiles. You can then:

  1. Customize profiles with gclone profile add/remove
  2. Set up SSH configuration with gclone ssh-config
  3. Clone repositories with gclone clone

Examples:

# Clone with explicit profile
gclone clone git@github.com:user/repo.git --profile=personal

# Clone with automatic profile detection
gclone clone git@github.com:your-personal-username/repo.git

# Clone with additional options
gclone clone git@github.com:user/repo.git --depth=1 --branch=main

Installation

Using Go

go install github.com/user-cube/gclone@latest

Requirements

  • Go 1.23 or later (for building from source)
  • Git client

What's Changed

New Contributors

Full Changelog: https://github.com/user-cube/gclone/commits/v1.0.0