gitignore-create

gitignore-create writes .gitignore files from the command line. It gets the templates from the Toptal gitignore API.

Install

uv tool install gitignore-create
# or
pipx install gitignore-create

Python 3.10 or later is necessary.

Usage

# Interactive selection
gitignore-create

# Write ./.gitignore for one or more templates
gitignore-create -n python linux

# Write to a different directory
gitignore-create -n python -p path/to/project

# Add to an existing .gitignore
gitignore-create -n node --append

# Replace an existing .gitignore
gitignore-create -n node --force

# Add custom lines after the templates
gitignore-create -n python -e "secrets.toml"

# Print the result and write nothing
gitignore-create -n python --preview

# List or search the available templates
gitignore-create --list
gitignore-create --search rust

If .gitignore exists, the command stops unless you pass --append or --force.

Interactive mode

gitignore-create with no template names opens a picker with vim keys:

The picker writes to the -p directory and appends if .gitignore exists.

Development

uv sync --group dev
uv run pytest