gitslice

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #llm #rust #linux #docker #nodejs #windows #awesome #cli #vue #openai

(★ 20)

Fast CLI to extract folders or files from GitHub repos using sparse-checkout

gitslice 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🧩 GitSlice CLI

**A CLI tool to extract specific folders or file from GitHub repositories using sparse-checkout.**  
Designed for speed, simplicity, and developers who don't want to clone massive repos unnecessarily.

---

## 🚀 Features

- ⚡️ Extract a specific folder or file from any GitHub repo
- 🔍 Automatically resolves deep nested paths like `/tree/branch/src/utils/`
- 🌲 Uses Git sparse-checkout for minimal clone footprint
- 🧹 Cleans up temp files after extraction
- 🔄 Supports both full clone and sparse mode
- 🧠 Intelligent path matching without needing full repo history

---

## 📦 Installation

### With Go

```bash
go install github.com/05sanjaykumar/gitslice@latest
````

### Or clone and build:

```bash
git clone https://github.com/05sanjaykumar/gitslice
cd gitslice
go build -o gitslice main.go
```

---

## 🛠️ Usage

### Basic Syntax

```bash
gitslice <github-folder-or-file-url>
```

### Examples

```bash
gitslice https://github.com/supabase/storage/tree/fix/pgboss-on-error-callback/src/auth
```

```bash
gitslice https://github.com/vercel/next.js/tree/canary/packages/next
```

```bash
gitslice https://github.com/05sanjaykumar/Flappy-Bird-OpenCV/blob/main/assets/background-day.png
```

### Output

* Extracts folder/file to the current directory.
* Auto-detects branch and path.

---

## 📋 CLI Options

```bash
gitslice --help      # Show help
gitslice --version   # Show version
```

---

## 🧠 How It Works

1. Parses the GitHub URL and extracts the owner, repo, branch, and folder or file path.
2. Clones the repo in sparse mode without full checkout.
3. Sets up sparse-checkout for the specific folder or file.
4. Switches to the correct branch and checks out only the required path.
5. Moves the folder or file to your working directory and cleans up.

---

## 🆚 GitSlice vs Manual Git Commands

### With GitSlice ✨
```bash
gitslice https://github.com/user/repo/tree/branch/folder
```

### Manual Git Way 😵
```bash
git clone --filter=blob:none --sparse https://github.com/user/repo
cd repo
git sparse-checkout init --cone
git sparse-checkout set folder
git checkout branch
cp -r folder ../
cd ..
rm -rf repo
```

**GitSlice does in 1 command what takes 7 manual steps:**
- ✅ Parses GitHub URLs automatically
- ✅ Handles branch detection
- ✅ Sets up sparse-checkout configuration
- ✅ Manages temporary directories
- ✅ Cleans up after extraction
- ✅ Works with both folders and individual files
- ✅ Remembers the complex git syntax so you don't have to

*Yes, GitSlice requires git to be installed - just like how npm requires Node.js, docker-compose requires Docker, and gh requires git. It's a productivity wrapper that makes complex git operations simple and accessible.*

## ⚠️ Limitations & Edge Cases

Despite its power, `GitSlice` does have a few **known limitations**:

* **Branch-specific folders only**: If a folder or a file exists *only* in a non-default branch (e.g., not in `main`), `GitSlice` might not detect or clone it correctly unless the branch is explicitly specified in the URL.

* **Private repositories**: GitSlice currently only works with **public GitHub repositories**. Support for private repos (with authentication) is not yet implemented.

* **Path guessing limitations**: The CLI resolves folder or file paths by pattern matching on local clone results. In very complex or dynamically generated repos, edge cases may slip through.

* **Shallow branch detection**: We don't fetch the full remote branch list — only the default or specified branch is used for sparse-checkout. If you mistype the branch name or forget it in the URL, cloning will fail.

* **No submodule support (yet)**: Git submodules aren't handled or fetched. This tool assumes you're targeting standalone folders.

* **GitHub-only**: Currently supports only GitHub URLs. Support for GitLab, Bitbucket, etc., is on the roadmap.

---

## 🔒 Requirements

* Git installed and available in PATH
* Go 1.18+ (for building from source)

---

## 📄 License

---

## ❤️ Contributing

Pull requests and issues are welcome!
If you hit an edge case or repo structure the tool doesn't support, open an issue and let’s improve it together.

---
## Logo Image

![Gitslice CLI](https://github.com/user-attachments/assets/5668c238-83b8-4cc0-b96e-1394e96ebe39)

gitslice

gitslice 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

gitslice

gitslice 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README