My opinionated gitconfig

Installation

cd ~/.config
git clone [email protected]:fprochazka/gitconfig.git

Include configs using a ~/.gitconfig

[include]
    path = /home/fprochazka/.config/gitconfig/config/main.gitconfig

[user]
    name = your-name
    email = your-email
    signingkey = 123456789123456798123456789

[init]
    defaultBranch = main

[includeIf "gitdir:/home/fprochazka/devel/my-company/"]
    path = /home/fprochazka/devel/my-company/.gitconfig

Installation of diff-highlight

1. git clone [email protected]:git/git.git
2. cd git/contrib/diff-highlight
3. make
4. sudo mv diff-highlight /usr/local/bin/diff-highlight

Issue Tracking Configuration

To use git issue-branch and git issue-mr commands, configure your issue tracking system:

[issue-tracking]
    system = linear                    # Supported: linear (more coming)
    linearToken = lin_api_xxxxxxxxxx   # Or use LINEAR_API_TOKEN env var

Per-company configuration works via includeIf:

# In /home/user/devel/my-company/.gitconfig
[issue-tracking]
    linearToken = lin_api_company_token

Custom Git Commands

This gitconfig provides many custom git commands and aliases for enhanced productivity:

Project Initialization

• git start - Initialize repository with an initial empty commit

Branch History & Information

• git h - Print history of current branch without pager (useful for terminal output)
• git get-main-branch - Auto-detect main branch name (master or main)
• git get-main-upstream-branch - Get upstream branch name (upstream/main or origin/main)
• git get-current-branch - Get current branch name, even during rebase

Work-in-Progress Management

• git wip - Stage all changes and commit as "WIP [ci skip]"
• git unwip - Undo the last WIP commit (reset HEAD~1)

Smart Commit Operations

• git cif - Commit as fixup to the latest non-fixup commit
• git cifi - Interactive fixup commit selection
• git slurp - Move staged changes to previous commit (amend with unstaging)
• git aiu - Track AI usage in commits by managing author and Co-authored-by metadata

Branch Management & Cleanup

• git com - Checkout main branch, pull, and also run git cleanup
• git cleanup - Fetch all remotes, prune, and drop merged/gone branches
• git branches-merged-list - List local branches merged into main
• git branches-merged-drop - Delete cleanly merged branches
• git branches-gone-list - List branches whose remotes are gone
• git branches-gone-drop - Delete branches with gone remotes

Stacked Branch Workflows

• git branches-stacked-list - List branches containing commits from current branch
• git fpush-stack - Force-push all branches updated by rebase --update-refs

Advanced Operations

• git up - Stash changes, fetch, and pull from upstream
• git pu - Run up command then push main branch to upstream
• git permission-reset - Reset file permissions to match repository

File & Content Search

• git find <pattern> - Find files in repository by name pattern
• git cf <commit> - Show files changed in a commit

Repository Management

• git sync-all-repos [dir] - Recursively sync all git repositories in directory
• git gitlab-clone-all - Clone all repositories from a GitLab group (uses glab CLI for auth)
• git github-clone-all --org=ORG - Clone all repositories from a GitHub organization including wikis (uses gh CLI for auth)
• git remote-host-provider [remote] - Detect if remote is GitHub or GitLab (cached)
• git upstream-info [--name-only] - Show if origin is a fork and what the parent repo is

Merge/Pull Request Operations

• git mr-status [branch] - Show MR/PR status for current branch (GitLab and GitHub)
• git pr-status [branch] - Alias for mr-status

Issue Tracking Integration

• git issue-branch <issue-id> - Create or checkout a branch for an issue (e.g., fp/ENG-123-fix-login-bug)
• git issue-branch -w <issue-id> - Same as above but creates a git worktree at <project>-worktrees/<branch-dir>
• git issue-mr [issue-id] - Push branch and create GitLab MR / GitHub PR with issue title
• git worktree-cleanup - Interactive worktree removal with branch info (upstream status, commit message)

These commands integrate with issue tracking systems (currently Linear) to:

• Fetch issue title for branch naming and MR/PR titles
• Auto-detect GitLab vs GitHub and use appropriate CLI (glab / gh)
• Check for existing open MR/PR before creating duplicates
• Create as draft with "remove source branch after merge" and auto-assign to you

Other aliases & shortcuts

See config/aliases.gitconfig

Development

Linting

Run shellcheck on all scripts:

make lint        # Check with warning severity
make lint-all    # Check with style severity (stricter)

Testing

make test        # Bash syntax check on all scripts
make test-help   # Verify all scripts respond to --help

Requirements

• shellcheck - Install via apt install shellcheck or brew install shellcheck