gitignorio-cli

Create and update .gitignore files using gitignore.io with automatic language detection.

Install from PyPI:

pip install gitignorio-cli
# or
uv tool install gitignorio-cli

For local development:

uv tool install .
# or
pip install .

Usage

The command is gi:

gi create              # OS template + detected languages
gi create --no-detect  # OS template only
gi update              # append newly detected languages
gi add python node     # append specific templates
gi list                # list available templates
gi hooks install       # auto-create/update .gitignore via git hooks

Use --path / -p to target a directory other than the current one.

Git hooks

Install hooks once per repository (or use --global to seed new repos created with git init):

gi hooks install
gi hooks install --global

This installs:

• post-checkout — creates .gitignore when a repository is initialized (clone/checkout) if one does not exist
• pre-push — updates .gitignore before each push, or creates it if missing

Existing hook scripts managed by gitignore-cli are updated in place. Other hook scripts are left intact and receive an appended gitignore-cli block.

Running gi hooks install also creates .gitignore immediately when it is missing in the current repository.

Language detection

create and update use github-linguist and magika. The CLI installs them automatically on first run if Ruby gem and pipx are available.

License

MIT — see LICENSE.md.

Templates are bundled locally (sourced from gitignore.io) and work offline. To refresh them:

python scripts/download_templates.py

Generated .gitignore content is CC0.