unigit
v0.0.5
Published
A universal git repository cloning tool that works with any git provider via SSH.
Readme
unigit
A universal git repository cloning tool that works with any git provider via SSH.
What is unigit?
unigit is a simple command-line tool that clones git repositories using SSH, making it compatible with any git hosting provider that supports SSH access. Unlike other popular tools like degit or gitpick, unigit doesn't rely on specific platform APIs, making it truly universal.
Why unigit?
The Problem
Most git cloning tools are optimized for popular platforms like GitHub and GitLab, using their specific APIs for fast downloads. However, these tools often fail when working with:
- Self-hosted git servers
- Lesser-known git hosting providers
- Internal corporate repositories
- Custom git implementations
The Solution
unigit takes a different approach by using standard SSH git cloning. This makes it slower but more universal - it works anywhere SSH git access is available.
⚠️ Important: When to Use unigit
This tool is NOT a replacement for degit, gitpick, or similar tools. Here's when to use each:
Use degit/gitpick when:
- Cloning from GitHub, GitLab, or Bitbucket
- You want the fastest possible download
Use unigit when:
- Cloning from unsupported git providers
- Working with self-hosted git servers
- You need a universal fallback option
- The other tools don't work for your use case
Installation
npm install -g unigitUsage
Basic Usage
# Clone from a full SSH URL
unigit [email protected]:user/repoCommand Line Options
unigit [repository] [destination] [options]
Options:
-p, --path <path> Clone a specific subdirectory
-b, --branch <name> Clone on a specific branch
-d, --destination <dir> Specify destination directory
-h, --help Show helpContributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
ISC License - see the LICENSE file for details.
