git-clone-select

A CLI tool for cloning git repositories into organized project folders with interactive directory selection.

Install

From npm (Recommended)

npm install -g git-clone-select

Linux users (one-time setup):

If you get permission errors, configure npm once:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

After this one-time setup, you can use npm install -g for any package without sudo or permission issues.

From source

For development or to install from source:

git clone https://github.com/aikengunay/git-clone-select.git
cd git-clone-select
npm install -g .

The -g flag installs the package globally, making git-clone-select available from any directory in your terminal.

Usage

git-clone-select <git-url>

Run git-clone-select from any directory. On first run, you'll be prompted to set up your projects directory. The tool will then prompt you to select or create a destination folder.

Examples:

git-clone-select https://github.com/user/repo.git
git-clone-select [email protected]:user/repo.git

Features

• Interactive folder selection
• Create folders in root or nested locations
• Automatic repository name extraction
• URL validation and overwrite protection
• Option to open cloned repository in Cursor editor
• Cross-platform support (Windows, macOS, Linux)
• Configurable projects directory

Configuration

First-time Setup

On first run, git-clone-select will prompt you to set up your projects directory. You can choose any location within your home directory.

Config Commands

# Show current configuration
git-clone-select --config

# Set projects directory
git-clone-select --set-config ~/MyProjects

# Reset configuration
git-clone-select --reset-config

# Show version
git-clone-select --version

# Show help
git-clone-select --help

Environment Variable

You can also set the projects directory using an environment variable:

export GIT_CLONE_PROJECTS_DIR=~/MyProjects
git-clone-select https://github.com/user/repo.git

Default Paths

• Windows: C:\Users\Username\Projects
• macOS: ~/Developer/Projects (or ~/Projects)
• Linux: ~/Projects or ~/Developer/Projects

Config file location: ~/.config/git-clone-select/config.json

Requirements

• Node.js 14 or higher
• Git
• npm

Platform Support

Windows

Full support via Git for Windows

macOS

Full support

Linux

Full support (for npm global installs, configure npm prefix to avoid permission errors - see Install section)

Uninstall

npm uninstall -g git-clone-select

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT