Git 2.49+ features including git-backfill, path-walk API, and performance improvements
/plugin marketplace add JosiahSiegel/claude-plugin-marketplace/plugin install git-master@claude-plugin-marketplaceThis skill inherits all available tools. When active, it can use any tool Claude has access to.
What: Efficiently download missing objects in partial clones using the path-walk API.
Why: Dramatically improves delta compression when fetching objects from partial clones, resulting in smaller downloads and better performance.
# Check if you have a partial clone
git config extensions.partialClone
# Download missing objects in background
git backfill
# Download with custom batch size
git backfill --batch-size=1000
# Respect sparse-checkout patterns (only fetch needed files)
git backfill --sparse
# Check progress
git backfill --verbose
Scenario 1: After cloning with --filter=blob:none
# Clone without blobs
git clone --filter=blob:none https://github.com/large/repo.git
cd repo
# Later, prefetch all missing objects efficiently
git backfill
Scenario 2: Sparse-checkout + Partial clone
# Clone with both optimizations
git clone --filter=blob:none --sparse https://github.com/monorepo.git
cd monorepo
git sparse-checkout set src/api
# Fetch only needed objects
git backfill --sparse
Scenario 3: CI/CD Optimization
# In CI pipeline - fetch only what's needed
git clone --filter=blob:none --depth=1 repo
git backfill --sparse
# Much faster than full clone
Traditional partial clone fetch:
git fetch --unshallow
# Downloads 500MB in random order
# Poor delta compression
With git-backfill:
git backfill
# Downloads 150MB with optimized delta compression (70% reduction)
# Groups objects by path for better compression
What: Internal API that groups together objects appearing at the same path, enabling much better delta compression.
How it works: Instead of processing objects in commit order, path-walk processes them by filesystem path, allowing Git to find better delta bases.
Benefits:
You benefit automatically when using:
git backfillgit repack (improved in 2.49)# For repack operations
git config pack.useBitmaps true
git config pack.writeBitmaps true
# Repack with path-walk optimizations
git repack -a -d -f
# Check improvement
git count-objects -v
What: Git 2.49 includes improved performance through zlib-ng integration for compression/decompression.
Benefits:
Automatically improves:
git clonegit fetchgit pushgit gcgit repackWhat: Improved algorithm for selecting object pairs during delta compression.
Results:
Automatic - no action needed.
What: Git 2.49 added Rust bindings (libgit-sys and libgit-rs) for Git's internal libraries.
Relevance: Future Git tooling and performance improvements will leverage Rust for memory safety and performance.
For developers: You can now build Git tools in Rust using official bindings.
What: Servers can now advertise promisor remote information to clients.
Benefits:
Configuration:
# View promisor remote info
git config remote.origin.promisor
git config extensions.partialClone
# Verify promisor packfiles
ls -lah .git/objects/pack/*.promisor
# Clone large monorepo with maximum efficiency
git clone --filter=blob:none --sparse https://github.com/company/monorepo.git
cd monorepo
# Only checkout your team's service
git sparse-checkout set --cone services/api
# Fetch needed objects with path-walk optimization
git backfill --sparse
# Result: 95% smaller than full clone, 70% faster download
# .github/workflows/ci.yml
jobs:
test:
runs-on: ubuntu-latest
steps:
- name: Checkout with optimizations
run: |
git clone --filter=blob:none --depth=1 --sparse ${{ github.repositoryUrl }}
cd repo
git sparse-checkout set src tests
git backfill --sparse
- name: Run tests
run: npm test
# 80% faster than full clone in CI
# Clone repository with massive history
git clone --filter=blob:none https://github.com/project/with-long-history.git
cd with-long-history
# Work on recent code only (objects fetched on demand)
git checkout -b feature/new-feature
# When you need full history
git backfill
# Repack for optimal storage
git repack -a -d -f # Uses path-walk API
⚠️ Now Officially Deprecated:
.git/branches/ directory (use remotes instead).git/remotes/ directory (use git remote commands)Migration:
# If you have old-style remotes, convert them
# Check for deprecated directories
ls -la .git/branches .git/remotes 2>/dev/null
# Use modern remote configuration
git remote add origin https://github.com/user/repo.git
git config remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*'
What: Continued development on Meson as alternative build system for Git.
Why: Faster builds, better cross-platform support.
Status: Experimental - use make for production.
What: HTTP transport now supports .netrc for authentication.
Usage:
# ~/.netrc
machine github.com
login your-username
password your-token
# Git will now use these credentials automatically
git clone https://github.com/private/repo.git
Use git-backfill for partial clones:
git backfill --sparse # Better than git fetch --unshallow
Combine optimizations:
git clone --filter=blob:none --sparse <url>
git sparse-checkout set --cone <paths>
git backfill --sparse
Regular maintenance:
git backfill # Fill in missing objects
git repack -a -d -f # Optimize with path-walk
git prune # Clean up
Monitor partial clone status:
# Check promisor remotes
git config extensions.partialClone
# List missing objects
git rev-list --objects --all --missing=print | grep "^?"
Migrate deprecated features:
# Move away from .git/branches and .git/remotes
# Use git remote commands instead
git-backfill not found:
# Verify Git version
git --version # Must be 2.49+
# Update Git
brew upgrade git # macOS
apt update && apt install git # Ubuntu
Promisor remote issues:
# Reset promisor configuration
git config --unset extensions.partialClone
git config --unset remote.origin.promisor
# Re-enable
git config extensions.partialClone origin
git config remote.origin.promisor true
Poor delta compression:
# Force repack with path-walk optimization
git repack -a -d -f --depth=250 --window=250
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.