This command kicks off Git’s built-in background maintenance to keep your repository optimized and healthy.
When you run this command, it launches a background daemon that periodically executes configured tasks such as garbage collection, repacking, commit-graph writing, reflog expiration, and repository consistency checks. You can target a specific task with --task=<name>
, adjust or override the schedule interval with --schedule=<interval>
, enable automatic scheduling with --auto
, or disable scheduling with --disable
.
For immediate execution without a persistent process, use git maintenance run
; to stop the background service, use git maintenance stop
; and for individual housekeeping operations you can also rely on legacy commands like git gc --auto
, git repack
, or git fsck
.