hayeah/git-quick-clone

git-quick-clone

Clone GitHub repos with treeless partial clone (--filter=tree:0), sparse checkout auto-detection, and sensible branch setup.

Common use cases

# Clone user/repo — default: treeless partial clone (full history, smallest download)
git-quick-clone user/repo

# Clone from a full GitHub URL (query params are stripped automatically)
git-quick-clone https://github.com/user/repo?tab=readme-ov-file

# Paste a GitHub tree URL — sparse checkout is auto-detected
git-quick-clone https://github.com/user/repo/tree/main/path/to/dir

# Same for blob URLs — checks out the containing directory
git-quick-clone https://github.com/user/repo/blob/main/docs/guide.md

# Clone into a specific directory
git-quick-clone user/repo my-local-dir

# Full clone (no filters, no depth limit)
git-quick-clone user/repo --full

# Shallow depth override (legacy --depth behavior)
git-quick-clone user/repo --shallow 1

# Authenticate with a token (or set GITHUB_ACCESS env var)
git-quick-clone user/repo --token ghp_xxxxx

Notes

• Default clone uses --filter=tree:0 (treeless partial clone) — full commit history, trees/blobs fetched on demand.
• Submodules use the same --filter=tree:0 by default.
• Destination defaults to user/repo (creates nested directory).
• Always sets up a local master branch tracking the remote default branch.
• Initializes submodules automatically (unless sparse checkout is active).
• --shallow N falls back to legacy --depth=N behavior (truncated history).
• Safe to re-run if interrupted: git init + git fetch are idempotent on an existing directory.