Published: Fri 03 October 2025
By Thomas Langston
In Git .
tags: monorepo
Working with large monorepos can be challenging, especially when it comes to managing Git operations like fetching. In repositories with hundreds or thousands of branches, a simple git fetch can become slow and resource-intensive. Understanding how to configure fetch rules can dramatically improve your workflow.
Understanding the Default Fetch Configuration
When you clone a repository, Git automatically sets up a default fetch refspec that looks like this:
remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*
Let's break down what this configuration means:
+ - The plus sign allows non-fast-forward updates, meaning it will update local remote-tracking branches even if the remote branch has been rebased or force-pushedrefs/heads/* - The source pattern that matches all branches on the remote (the wildcard * matches any branch name)refs/remotes/origin/* - The destination pattern where remote branches are stored locally
This default configuration tells Git to fetch every single branch from the remote repository and store them as remote-tracking branches in your local repository.
The Problem with Large Monorepos
In a large monorepo, this default behavior can cause several issues:
Slow fetch operations - Downloading metadata for thousands of branches takes timeCluttered branch listings - Commands like git branch -r become unwieldy
Using Fetch Exclusions
Git provides a solution through negative refspecs, which allow you to exclude specific branches from being fetched. You can configure exclusions using the remote.origin.fetch configuration.
Excluding Feature Branches
A common pattern is to exclude short-lived feature branches while keeping main development branches:
git config --add remote.origin.fetch "^refs/heads/feature/*"
The ^ prefix creates a negative refspec that excludes matching branches.
Fetching Only Specific Branches
For even more control, you might want to fetch only specific branches:
# Remove all fetch rules
git config --unset-all remote.origin.fetch
# Add your first specific branches you care about
git config remote.origin.fetch "+refs/heads/main:refs/remotes/origin/main"
# Add additional specific branches
git config --add remote.origin.fetch "+refs/heads/release/release-latest:refs/remotes/origin/release/release-latest"
Fetching On-Demand
Even with exclusions configured, you might occasionally need to fetch a specific branch that's normally excluded:
# Fetch a specific excluded branch
git fetch origin feature/important-fix:refs/remotes/origin/feature/important-fix
Checking Your Current Configuration
To see your current fetch configuration:
git config --get-all remote.origin.fetch
This will show all configured fetch refspecs for the origin remote.
Conclusion
Thoughtful configuration of Git fetch rules can significantly improve your experience working with large monorepos. By excluding unnecessary branches and fetching only what you need, you can reduce fetch times, save disk space, and keep your local repository focused on the branches that matter to your work.
Remember that these configurations are local to your repository clone, so each developer can customize their fetch strategy based on their specific needs and workflow.