Skip to content

Partial clone and promisor remote — quick reference ​

Clone types ​

CommandDownloadsUse for
git clone --filter=blob:none <url>Commits + trees; blobs on demandDeveloper workstations
git clone --filter=tree:0 <url>Commits only; trees + blobs on demandCI pipelines, stateless checks
git clone --filter=blob:limit=1m <url>Blobs < 1 MB; larger on demandMixed-source monorepos
git clone <url> (no filter)EverythingFull offline access

Inspect promisor status ​

bash
# Check if repo is partial clone
git rev-list --missing=print --all --objects | head -5

# Count missing objects
git rev-list --missing=print --all --objects | wc -l

# List promisor remotes
git config --no-type --list | grep promisor

# Verify extension enabled
git config extensions.partialClone

# Check remote filter setting
git config remote.origin.partialclonefilter

Force materialization ​

bash
# Pre-fetch blobs for a path
git checkout HEAD -- src/services/auth/
git reset HEAD -- src/services/auth/

# Full promisor re-fetch (ignores local store)
git fetch --refetch origin

# Re-fetch all promisor remotes
git fetch --refetch --all

Maintenance ​

bash
git maintenance start                       # background prefetch + repack
git config fetch.negotiationAlgorithm skipping  # faster negotiation
git fsck --connectivity-only --no-dangling  # safe check in partial clones

Troubleshooting ​

bash
# "bad object deadbeef" — promisor unreachable
git config remote.origin.promisor false
git fetch --refetch origin
git config remote.origin.promisor true

# Server doesn't support filters (protocol v2)
git clone <url> repo   # drop --filter, full clone

# Check protocol version
git ls-remote --refs origin 2>&1 | head -3

Promisor config keys ​

SettingPurpose
remote.origin.promisor = trueMarks remote as promisor source
remote.origin.partialclonefilter = blob:noneFilter on promisor fetches
extensions.partialClone = originEnables partial clone repo-wide
fetch.negotiationAlgorithm = skippingFast ref negotiation
protocol.version = 2Required for filter support

Git Master — Git Reference for Every Skill Level