{"id":3956,"date":"2026-10-11T20:45:44","date_gmt":"2026-10-11T18:45:44","guid":{"rendered":"https:\/\/planetozh.com\/blog\/?p=3956"},"modified":"2026-10-11T20:45:44","modified_gmt":"2026-10-11T18:45:44","slug":"a-per-repo-untracked-gitignore-local","status":"publish","type":"post","link":"https:\/\/planetozh.com\/blog\/2026\/10\/a-per-repo-untracked-gitignore-local\/","title":{"rendered":"A per-repo, untracked `.gitignore-local`"},"content":{"rendered":"

You have files that you want to ignore, but that have no business being in the project's .gitignore<\/code>: a a local test script, some draft assets. Adding them to .gitignore<\/code> would mean committing your personal clutter for everyone. Leaving them alone means git status<\/code> keeps nagging about untracked files.<\/p>\n

Git has a built-in answer for this, .git\/info\/exclude<\/code>, but it's tucked away inside .git\/<\/code> where I never look, and I tend to forget what's in it. I wanted something visible, right at the root of the repo, that works the same way in all my local repositories.<\/p>\n

Step 1: a global excludes file<\/h2>\n

Git lets you define an additional ignore file with core.excludesfile<\/code>. Most people point it to a global file in their home directory. The trick here is to give it a relative<\/strong> path instead:<\/p>\n

git config --global core.excludesfile .gitignore-local\n<\/code><\/pre>\n
Every repo now can have its own optional .gitignore-local<\/code>, read just like a regular .gitignore<\/code>, but never shared.<\/p>\n
There's one catch: the .gitignore-local<\/code> file itself shows up as untracked. The fix is to make it ignore itself, by having .gitignore-local<\/code> as its first line:<\/p>\n
.gitignore-local\n# local files you want to ignore but not share via regular .gitignore:\ntest-script.py\nassets\/img\/test-logo.png\n<\/code><\/pre>\n
Doing that by hand in every repo gets old fast.<\/p>\n
Step 2: a git ignore-local<\/code> alias<\/h2>\n
So here's an alias that takes care of it:<\/p>\n
git config --global alias.ignore-local '!f() {\n    file=.gitignore-local\n    grep -qxF "$file" "$file" 2>\/dev\/null || echo "$file" >> "$file"\n    [ $# -eq 0 ] && { cat "$file"; return; }\n    for p in "$@"; do\n        grep -qxF -- "$p" "$file" || echo "$p" >> "$file"\n    done\n}; f'\n<\/code><\/pre>\n
What it does:<\/p>\n
    \n
  • Shell aliases (the ones starting with !<\/code>) always run from the root of the repository, so the file lands in the right place even if you call the alias from a subdirectory.<\/li>\n
  • If .gitignore-local<\/code> doesn't exist yet, or exists without its self-ignoring line, that line is added.<\/li>\n
  • Each pattern is appended only once, so no duplicates.<\/li>\n
  • Called without arguments, it just prints the current list.<\/li>\n<\/ul>\n
    Usage<\/h2>\n
    git ignore-local omgyes "*.mp3"   # ignore stuff locally\ngit ignore-local                  # show what's ignored\n<\/code><\/pre>\n
    And git status<\/code> stays clean:<\/p>\n
    On branch main\nYour branch is up to date with 'origin\/main'.\n\nnothing to commit, working tree clean\n<\/code><\/pre>\n
    If you ever wonder why a file is ignored, git check-ignore -v <file><\/code> tells you which rule matched and in which file.<\/p>\n","protected":false},"excerpt":{"rendered":"
    You have files that you want to ignore, but that have no business being in the project's .gitignore: a a local test script, some draft assets. Adding them to .gitignore would mean committing your personal clutter for everyone. Leaving them alone means git status keeps nagging about untracked files. Git has a built-in answer for this, .git\/info\/exclude, but it's tucked\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_ozhmd_markdown":"You have files that you want to ignore, but that have no business being in the project's `.gitignore`: a a local test script, some draft assets. Adding them to `.gitignore` would mean committing your personal clutter for everyone. Leaving them alone means `git status` keeps nagging about untracked files.\r\n\r\nGit has a built-in answer for this, `.git\/info\/exclude`, but it's tucked away inside `.git\/` where I never look, and I tend to forget what's in it. I wanted something visible, right at the root of the repo, that works the same way in all my local repositories.\r\n\r\n## Step 1: a global excludes file\r\n\r\nGit lets you define an additional ignore file with `core.excludesfile`. Most people point it to a global file in their home directory. The trick here is to give it a **relative** path instead:\r\n\r\n```bash\r\ngit config --global core.excludesfile .gitignore-local\r\n```\r\n\r\nEvery repo now can have its own optional `.gitignore-local`, read just like a regular `.gitignore`, but never shared.\r\n\r\nThere's one catch: the `.gitignore-local` file itself shows up as untracked. The fix is to make it ignore itself, by having `.gitignore-local` as its first line:\r\n\r\n```\r\n.gitignore-local\r\n# local files you want to ignore but not share via regular .gitignore:\r\ntest-script.py\r\nassets\/img\/test-logo.png\r\n```\r\n\r\nDoing that by hand in every repo gets old fast.\r\n\r\n## Step 2: a `git ignore-local` alias\r\n\r\nSo here's an alias that takes care of it:\r\n\r\n```bash\r\ngit config --global alias.ignore-local '!f() {\r\n    file=.gitignore-local\r\n    grep -qxF \"$file\" \"$file\" 2>\/dev\/null || echo \"$file\" >> \"$file\"\r\n    [ $# -eq 0 ] && { cat \"$file\"; return; }\r\n    for p in \"$@\"; do\r\n        grep -qxF -- \"$p\" \"$file\" || echo \"$p\" >> \"$file\"\r\n    done\r\n}; f'\r\n```\r\n\r\nWhat it does:\r\n\r\n- Shell aliases (the ones starting with `!`) always run from the root of the repository, so the file lands in the right place even if you call the alias from a subdirectory.\r\n- If `.gitignore-local` doesn't exist yet, or exists without its self-ignoring line, that line is added.\r\n- Each pattern is appended only once, so no duplicates.\r\n- Called without arguments, it just prints the current list.\r\n\r\n## Usage\r\n\r\n```bash\r\ngit ignore-local omgyes \"*.mp3\"   # ignore stuff locally\r\ngit ignore-local                  # show what's ignored\r\n```\r\n\r\nAnd `git status` stays clean:\r\n\r\n```\r\nOn branch main\r\nYour branch is up to date with 'origin\/main'.\r\n\r\nnothing to commit, working tree clean\r\n```\r\n\r\nIf you ever wonder why a file is ignored, `git check-ignore -v ` tells you which rule matched and in which file.","footnotes":""},"categories":[21],"tags":[396],"class_list":["post-3956","post","type-post","status-publish","format-standard","hentry","category-published","tag-git"],"_links":{"self":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts\/3956","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/comments?post=3956"}],"version-history":[{"count":1,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts\/3956\/revisions"}],"predecessor-version":[{"id":3957,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts\/3956\/revisions\/3957"}],"wp:attachment":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/media?parent=3956"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/categories?post=3956"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/tags?post=3956"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}