Overview
When to Use
Quick Start
Configuration Files
Global Settings
Rerere
Line Endings
Aliases
Clone Shortcuts
Repository-Level Config
Maintenance
Git Attributes
Credentials
Troubleshooting
Test Scenarios

Overview

This skill helps you:

Configure Git globally for optimal performance and workflow
Set up powerful aliases to streamline common operations
Manage Git credentials securely (GitHub CLI, Windows Credential Manager)
Configure .gitattributes for line ending control
Enable Git maintenance for better repository performance
Understand repository-level vs global configuration
Troubleshoot common configuration issues

For basic Git installation and setup, see the setup skill.

Example Use Cases

This skill activates for questions like:

"How do I set up Git aliases for common operations?"
"Configure Git to use GitHub CLI for authentication"
"My Git is slow on large repos - how can I optimize performance?"
"Set up .gitattributes for cross-platform development"
"Enable Git background maintenance"
"Troubleshoot 'refusing to allow OAuth App to create workflow' error"
"Configure Git credential helpers on Windows"
"Set up clone shortcuts for frequently-used repositories"
"Configure rerere to remember merge conflict resolutions"

When to Use This Skill

Use this skill when:

Configuring Git beyond basic user identity
Setting up aliases for common Git operations
Optimizing Git performance (fsmonitor, untrackedCache, parallel operations)
Managing Git credentials (HTTPS, SSH, token scopes)
Setting up GitHub CLI as credential helper
Configuring .gitattributes for cross-platform line ending control
Enabling Git background maintenance
Setting up clone shortcuts for frequently-used repositories
Troubleshooting credential issues or line ending errors
Understanding Git configuration hierarchy (system/global/local)

Quick Start

Most impactful configuration settings to apply immediately:

# Performance improvements
git config --global core.fsmonitor true
git config --global core.untrackedCache true
git config --global fetch.parallel 8
git config --global checkout.workers 8

# Better pull/rebase workflow
git config --global pull.rebase true
git config --global rebase.autoStash true
git config --global rebase.updateRefs true

# Auto-prune deleted remote branches
git config --global fetch.prune true
git config --global fetch.pruneTags true

# Better merge conflict resolution
git config --global merge.conflictstyle zdiff3

# Auto-setup remote tracking on first push
git config --global push.autoSetupRemote true

# Better diff algorithm
git config --global diff.algorithm histogram
git config --global diff.colorMoved zebra

# Line ending safety check
git config --global core.safecrlf warn

Quick Reference

Common Git configuration settings organized by category for quick lookup (performance, pull/rebase, fetch, push, diff, merge, line endings, sorting, maintenance).

📚 Complete Quick Reference Table: references/quick-reference.md

The quick reference table provides copy-paste commands for all common settings with category organization and purpose explanations.

Configuration File Locations

For detailed information about Git configuration file locations, hierarchy, and viewing configuration, see references/configuration-basics.md.

Quick summary:

System: /etc/gitconfig (or Git install dir on Windows) - All users
Global: ~/.gitconfig or ~/.config/git/config - Current user
Local: .git/config - Single repository only
Priority: Local > Global > System

View configuration:

# View all configuration with source files
git config --list --show-origin

# View specific value
git config user.name

Global Configuration Settings

These settings are cross-platform and recommended for all users. They should be set at the global level unless you need repository-specific overrides.

Most Essential Settings (Quick Start):

# Pull & rebase (cleaner history)
git config --global pull.rebase true
git config --global rebase.autoStash true

# Fetch (auto-prune deleted branches/tags)
git config --global fetch.prune true
git config --global fetch.pruneTags true
git config --global fetch.parallel 8

# Push (auto-setup remote tracking)
git config --global push.autoSetupRemote true

# Diff & merge (better algorithms and conflict display)
git config --global diff.algorithm histogram
git config --global diff.colorMoved zebra
git config --global merge.conflictstyle zdiff3

# Performance (filesystem monitoring)
git config --global core.fsmonitor true
git config --global core.untrackedCache true

# Sorting (newest first)
git config --global branch.sort -committerdate
git config --global tag.sort -taggerdate

📚 Complete Global Configuration Guide: references/global-configuration.md

Topics covered: Pull & rebase strategy, fetch strategy, push strategy, checkout/switch strategy, commit settings, status settings, diff settings, merge settings, rerere (conflict resolution memory), color settings, sorting, log settings, performance settings, submodule strategy, miscellaneous settings, and advanced configuration options.

Managing rerere (Reuse Recorded Resolution)

Git's rerere feature remembers how you resolved merge conflicts and can reapply those resolutions automatically.

Enable rerere:

git config --global rerere.enabled true
git config --global rerere.autoUpdate true

For detailed information about how rerere works, safety considerations, and management commands, see references/configuration-basics.md

Line Ending Strategy (Defense in Depth)

Cross-platform line ending management uses a layered approach:

System level (autocrlf): Platform-specific default (Windows: true, macOS/Linux: input)
Global level (safecrlf): Warns about MIXED endings (actual problems) but allows legitimate conversions
Repository level (.gitattributes): Explicit control per file type

Defense in depth: These settings are complementary, not conflicting:

autocrlf handles the conversion automatically
safecrlf=warn warns about PROBLEMS (mixed line endings) but doesn't block .gitattributes conversions
.gitattributes provides per-repo fine-grained control

Important: Don't use safecrlf=true when you have .gitattributes - it will block legitimate conversions and cause constant errors!

Platform-specific autocrlf settings:

Windows: git config --global core.autocrlf true (converts LF→CRLF on checkout, CRLF→LF on commit)
macOS/Linux: git config --global core.autocrlf input (converts CRLF→LF on commit, no conversion on checkout)
WSL: git config --global core.autocrlf input (same as Linux)

Global safecrlf setting (all platforms):

# Warn about mixed line endings (safeguard against problems)
# Use 'warn' not 'true' - allows .gitattributes to work without constant errors
git config --global core.safecrlf warn

For detailed .gitattributes setup and comprehensive line ending guidance, see the line-endings skill.

Aliases

Aliases provide shortcuts for common Git operations. Categories include: information & inspection, navigation, branch operations, staging/unstaging, committing, history editing, remote operations, and tag pushing workflows.

Most Common Aliases:

# Status and branch info
git config --global alias.st "status -sb"
git config --global alias.br "branch -vv"

# Modern branch switching
git config --global alias.co "switch"
git config --global alias.cob "switch -c"

# Quick amend
git config --global alias.amend "commit --amend --no-edit"

# Safe force push
git config --global alias.pfwl "push --force-with-lease"

📚 Complete Alias Guide: references/aliases.md

Topics covered: Information & inspection aliases, navigation utilities, branch operations, staging/unstaging shortcuts, committing helpers, history editing (DANGER!), remote operations, tag pushing workflows, clone shortcuts with url.insteadOf, organization/personal shorthand patterns, and customization templates.

Clone Shortcuts

Git's url.insteadOf feature creates shorthand prefixes for clone URLs. Example: git clone gh:username/repo instead of git clone git@github.com:username/repo.git.

Quick Example:

# Universal GitHub shorthand
git config --global url."git@github.com:".insteadOf "gh:"
# Usage: git clone gh:microsoft/vscode

📚 Complete Clone Shortcuts Guide: references/aliases.md#clone-shortcuts

Topics covered: Universal GitHub shorthand, organization/personal shortcuts, corporate Git servers, custom namespace templates, and usage examples.

Repository-Level Configuration

These settings are context-specific - use them in individual repos when needed, NOT as global defaults.

When to use repo-level config:

Repo-specific requirements (submodules, performance, size)
Overriding global settings for specific workflows
Team-specific conventions for that repository

Examples:

# Enable submodule recursion in a specific repo
git config submodule.recurse true

# Disable ahead/behind in a massive repo (performance)
git config status.aheadBehind false

# Override line ending strategy (with .gitattributes)
git config core.autocrlf false

Maintenance

Git can perform background maintenance to keep repositories fast (commit-graph updates, incremental repacking, loose object cleanup).

Quick Setup:

# Enable background maintenance once for your account
git maintenance start

# Register each active repo for maintenance
git maintenance register

# Enable commit-graph generation globally
git config --global gc.writeCommitGraph true

Common Commands:

# Run maintenance now
git maintenance run

# See which repos are registered
git config --global --get-all maintenance.repo

# Unregister a repo
git maintenance unregister

📚 Complete Maintenance Guide: references/global-configuration.md#maintenance

Topics covered: Background maintenance tasks, scheduling (hourly/daily/weekly), task configuration, disabling full gc, maintenance.auto setting, per-task enablement, troubleshooting maintenance issues.

Git Attributes

.gitattributes provides explicit control over line endings per file type. This is the recommended approach for cross-platform teams.

Best practice: Control endings in .gitattributes and use platform-appropriate autocrlf settings with safecrlf=warn.

Quick Example:

# Auto-detect text files and normalize line endings
* text=auto

# Force LF for scripts/config (shell and CI tools expect LF)
*.sh      text eol=lf
*.yml     text eol=lf
*.json    text eol=lf

# Force CRLF for Windows-specific files
*.ps1     text eol=crlf
*.cmd     text eol=crlf
*.bat     text eol=crlf

# Mark binaries
*.png binary
*.jpg binary
*.pdf binary

Normalize existing repos with mixed endings:

git add --renormalize .
git commit -m "Normalize line endings"

📚 For comprehensive .gitattributes setup, Git LFS patterns, and line ending strategy, see the line-endings skill.

Git Credential Management

Git uses credential helpers to store and retrieve authentication credentials for remote operations (clone, fetch, push). Understanding credential management is essential for secure, efficient Git workflows.

For comprehensive credential management guidance, see references/credential-management.md.

Quick overview:

Windows: Default credential helper is Windows Credential Manager (manager)
macOS: Default is macOS Keychain (osxkeychain)
Linux: Default is memory cache (cache) or libsecret for persistent storage
GitHub users: Hybrid setup recommended (gh CLI for GitHub, OS credential manager for others)

Quick setup for GitHub (hybrid approach):

# 1. Authenticate with gh CLI
gh auth login --scopes "repo,read:org,workflow" --git-protocol https

# 2. Configure gh CLI as credential helper for GitHub only
gh auth setup-git

# 3. Verify hybrid setup
git config --list | grep credential
# Should show:
# - credential.helper=manager (or osxkeychain/cache - OS default)
# - credential.https://github.com.helper=!gh auth git-credential (GitHub-specific)

Common credential issues:

"refusing to allow OAuth App to create or update workflow" → Need workflow scope
Git still uses old/wrong credentials → Clear OS credential cache
SSH vs HTTPS confusion → Check remote URL with git remote -v

For detailed troubleshooting, credential helper options, security best practices, and platform-specific guidance, see references/credential-management.md.

Troubleshooting

For comprehensive troubleshooting guidance, see references/troubleshooting.md.

Quick links:

Line Ending Errors - "LF would be replaced by CRLF" warnings
Credential Issues - OAuth errors, stale credentials, SSH vs HTTPS
Performance Problems - Slow git status, fetch timeouts
Common Real-World Scenarios - Corporate proxies, WSL issues, rerere problems

Related Skills

setup: Basic Git installation and initial configuration
line-endings: Comprehensive line ending configuration, .gitattributes, Git LFS
gpg-signing: GPG commit signing setup and troubleshooting
gui-tools: Git GUI client installation and configuration

Test Scenarios

For test scenarios validating skill activation and response quality, see references/test-scenarios.md.

Coverage: 9 scenarios covering basic use (aliases, performance, maintenance), advanced use (credentials, line endings, repo config), troubleshooting (credential issues, rerere), and shortcuts (clone shortcuts, url.insteadOf).

Version History

v1.3.0 (2025-11-25): Audit compliance improvements
- Extracted Test Scenarios to references/test-scenarios.md
- Reduced SKILL.md from 539 to ~475 lines (under 500-line recommendation)
- Improved progressive disclosure compliance
v1.2.0 (2025-11-12): Quality improvements based on audit recommendations
- Extracted Configuration File Locations to references/configuration-basics.md
- Extracted Managing rerere to references/configuration-basics.md
- Extracted Troubleshooting to references/troubleshooting.md
- Added multi-model testing notes
- Added common real-world usage scenarios
- Reduced SKILL.md line count from 959 to ~700 lines (improved performance)
- Added tables of contents to all reference files for better navigation
- Created references/troubleshooting.md with comprehensive troubleshooting guidance
v1.1.0 (2025-11-12): Usability enhancements based on audit feedback
- Added Example Use Cases section with concrete activation examples
- Added Quick Reference Table for quick lookup of common settings
- Improved autonomous activation reliability
v1.0.0 (2025-11-09): Initial release with comprehensive Git configuration guidance

Official Documentation

Last Updated

Date: 2025-11-28 Model: claude-opus-4-5-20251101

git-config

Git Configuration

Table of Contents