gitgrab v1.0.0

ICJIA GitGrab

A Node 18+ CLI tool to list, select, and bulk clone GitHub repositories.

Features

• Browse repositories from any GitHub user or organization
• Select multiple repositories to clone simultaneously
• Interactive selection interface
• Configurable repository storage location
• Elegant dashboard display of repository information

Why Use GitGrab?

There are several scenarios where bulk-cloning repositories is valuable:

Backup & Archival

• Local Backups: Create offline copies of all your organization's repositories
• Disaster Recovery: Maintain a complete backup of your codebase independent of GitHub
• Historical Preservation: Archive projects for future reference or compliance requirements

Development Efficiency

• New Developer Onboarding: Quickly set up a new team member with all relevant repositories
• Workstation Setup: Configure a new development machine with all your projects at once
• Multi-Project Work: Easily pull down related repositories when working across multiple codebases

Administration & Management

• Code Audits: Clone multiple repositories for security review or code quality assessment
• Migration: Facilitate moving projects between GitHub organizations or to other Git providers
• Inventory: Create a local inventory of all organizational code assets

Installation

Using npm:

npm install -g gitgrab

Using yarn:

yarn global add gitgrab

Using pnpm:

pnpm add -g gitgrab

Prerequisites

• Node.js 18 or later
• A GitHub Personal Access Token with "repo" scope
  • Create one at: https://github.com/settings/tokens

Usage

# Clone repositories from the default organization (ICJIA)
gitgrab

# Clone repositories from a specific user or organization
gitgrab octocat

# Specify a custom directory for cloning
gitgrab --directory ~/projects

# Limit the number of repositories displayed (max 15)
gitgrab --limit 10

# Use a specific GitHub token
gitgrab --token your_github_token

You can also store your GitHub token in a .env file: