cd ~/.config
git clone git@github.com: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

1. git clone git@github.com:git/git.git
2. cd git/contrib/diff-highlight
3. make
4. sudo mv diff-highlight /usr/local/bin/diff-highlight

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

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

• git start - Initialize repository with an initial empty commit

• 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 tracking branch of main (fails if not configured)
• git get-main-ref-for-rebase - Get tracking branch of main (falls back to local main)
• git get-current-branch - Get current branch name, even during rebase

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

• 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

• git com - Checkout main branch, pull, and also run git cleanup
• git cleanup - Fetch all remotes, prune, and drop merged/gone branches
• git branches-gc [--merged] [--gone] [--drop] - List/delete stale branches (merged or gone), excludes worktree branches

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

• 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

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

• git list-repos [dir] - List all git repositories as relative paths (does not descend into repos)
• 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 libs-clone <url> - Clone a repository into libs directory organized by <hostname>/<path> (configurable via clone.libs-dir, default ~/devel/libs)
• 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

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

• 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

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

• git wt <branch> - Checkout branch into a worktree (like git checkout but for worktrees, doesn't touch current workdir)
• git wt -b <branch> - Create new branch and checkout into a worktree
• git wt-cleanup - Interactive worktree removal with branch info (upstream status, commit message)

See config/aliases.gitconfig

Run shellcheck on all scripts:

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

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

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