git-clone-group 1.1.3

clone all group projects from gitlab

Git Clone Group (gcg)

A command-line tool to clone or update all projects from a GitLab group and its subgroups.

Features

• Clone/update all repositories in a GitLab group and its subgroups
• Support both group ID and group name/path
• Specify branch to clone/pull
• Parallel processing with progress bars
• Smart retry mechanism
• Empty repository detection
• Detailed statistics

Installation

You can install git-clone-group using pip:

pip install git-clone-group

Usage

Basic usage:

# By group ID
gcg -g GITLAB_ADDR -t TOKEN -i GROUP_ID [-d DEST_DIR] [-b BRANCH]

# By group name/path
gcg -g GITLAB_ADDR -t TOKEN -n GROUP_NAME [-d DEST_DIR] [-b BRANCH]

Show help:

gcg -h

Examples:

# Clone all projects from group ID 123 to current directory
gcg -g gitlab.com -t glpat-xxxxxxxxxxxx -i 123

# Clone all projects from group named 'my-team'
gcg -g gitlab.com -t glpat-xxxxxxxxxxxx -n my-team

# Clone from nested group using full path
gcg -g gitlab.com -t glpat-xxxxxxxxxxxx -n organization/my-team

# Clone to a specific directory
gcg -g gitlab.com -t glpat-xxxxxxxxxxxx -n my-team -d /path/to/repos

# Clone specific branch from private GitLab instance
gcg -g git.company.com -t glpat-xxxxxxxxxxxx -n my-team -d ./projects -b develop

# Clone default branches using group ID
gcg -g gitlab.com -t glpat-xxxxxxxxxxxx -i 123 -d ./repos

Getting a GitLab Access Token

1. Log in to your GitLab instance
2. Go to Settings > Access Tokens
3. Create a new personal access token with api scope
4. Copy the token and use it with the --token argument

Getting a Group ID or Name

Group ID

You can find the group ID in GitLab:

1. Go to your group's page
2. The group ID is shown in the group information panel
3. Or look at the URL: https://gitlab.com/groups/your-group-name - the group ID will be visible in the group details

Group Name/Path

You can use the group name or full path:

• Simple group name: my-team
• Full group path: organization/my-team
• If multiple groups match the search, you'll be prompted to choose

Notes

• The tool will automatically handle nested subgroups
• For existing repositories, it will perform a git pull
• Progress bars show real-time cloning/pulling status
• Both HTTP and SSH URLs are supported (SSH recommended)
• When using group names, if multiple matches are found, you'll be prompted to select the correct one