git reflog expire --expire-unreachable=now –all
Copy to clipboard

git reflog expire --expire-unreachable=now –all

In this command:

• git reflog expire: Expires or removes a reference from the reflog.
• --expire-unreachable=now: Sets the expiry date of all the local unreachable references tonow, effectively setting them up to be removed immediately.
• --all: Targets all the reflog entries that currently exist in the repository.

We can also use thegit prunecommand to set an expiration time for the local outdated references, after which they will be pruned:

git prune --expire=3.weeks.ago
Copy to clipboard

git prune --expire=3.weeks.ago

Here, the--expireflag sets an expiration time of3.weeks.ago, which indicates that Git will remove all the references that have been unreachable for more than 3 weeks. Some more examples of the expiration time can be2.months.ago,5.days.ago,yesterday, etc.

We discussed how to remove outdated references locally in Git, but what about removing them remotely?

In the next section, we’ll learn how to remove outdated references remotely in Git.

How to remove outdated references remotely in Git

When working on aremote repository, we may occasionally need to delete remote branches that are no longer required. Upon deletion, they are removed from the repository, but the references to these remote branches aren’t. Instead, these references exist in the repository as remote outdated references.

To remove these references, we can use thegit fetchcommand with--pruneflag:

git fetch --prune origin
Copy to clipboard

git fetch --prune origin

• git fetch: Fetches the latest changes (including any new remote outdated references) fromoriginto the local repository.
• --prune: Removes all the remote outdated references in the repository.
• origin: An alias for the forkeddocsremote repository.

If we want to remove outdated references remotely without fetching the latest changes, we can use this command instead:

git remote prune origin
Copy to clipboard

git remote prune origin

• git remote: Specifies the target remote repository (origin).
• prune: Removes all the remote outdated references in the repository.

Now that we’re done discussing how to remove outdated references locally and remotely in Git, let’s have a look at the advantages of usinggit prune.

Advantages of usinggit prune

The several advantages of using thegit prunecommand include:

• Reduces Clutter: Helps keep the repository clean by removing obsolete references.
• Frees Up Space: Reclaims disk space by deleting unreachable objects.
• Improves Performance: Enhances the performance of a repository by deleting unnecessary objects.
• Prevents Confusion: Reduces the chances of accidental usage of obsolete branches or commits by eliminating outdated references.

With the advantages covered, let’s next look at the ideal scenarios for usinggit prune.

When to usegit prune?

We can use thegit prunecommand in multiple scenarios, such as:

• After deleting branches to remove unnecessary references.
• When cleaning up stale references after performing afetchoperation.
• After performing a rebase or reset, which can leave behind unreachable commits that are no longer needed.

Conclusion

In this tutorial, we explored thegit prunecommand and learned how to remove local and remote outdated references in Git. We also covered its advantages and the ideal scenarios for using it.

Keeping our Git repositories clean usinggit pruneensures efficient repository management, better performance, and easier navigation of branches. Regular pruning helps maintain a well-structured repository, preventing unnecessary clutter and confusion.

If you want to learn more about Git branching and collaboration, check out theLearn Git: Branching and Collaborationcourse on Codecademy.

Frequently asked questions

1. What does git prune do?

Git prune removes unreachable objects and outdated references from your repository.

2. How do I use git prune safely?

Always rungit prune --dry-runfirst to preview changes, thengit pruneto execute.

3. Is git prune safe to use?

Yes, git prune only removes truly unreachable objects. It won’t delete anything referenced by branches or tags.

4. When should I run git prune?

After deleting branches, performing rebases, or when your repository feels cluttered.

5. What’s the difference between local and remote pruning?

Local pruning removes unreachable objects in your repository. Remote pruning removes references to deleted remote branches.

'The Codecademy Team, composed of experienced educators and tech experts, is dedicated to making tech skills accessible to all. We empower learners worldwide with expert-reviewed content that develops and enhances the technical skills needed to advance and succeed in their careers.'