git-kit

A modular Git alias distribution toolkit. Installs a curated set of Git aliases via a managed include file — without touching your existing configuration.

Features

• Installs Git aliases through a managed include file, not by overwriting your config
• Supports profiles (minimal, lazy, power) for different alias sets
• Switching profiles or targets automatically replaces the previous include — only one git-kit include is ever active at a time
• Safe uninstall that only removes the git-kit-managed include; --all cleans up everything at once
• Cross-platform: macOS, Linux, and Windows

Requirements

• Git 2.x or later
• Node.js 18 or later (required to install and run git-kit)

Installation

npm install -g @lukasmoeller/git-kit

Usage

Install aliases

Install the full alias set:

git-kit install

Install a specific profile:

git-kit install --profile minimal
git-kit install --profile lazy
git-kit install --profile power

List aliases

List all available aliases:

git-kit list

List aliases for a specific profile:

git-kit list --profile power

List profiles

git-kit profiles

Update aliases

Update the managed alias file with the latest aliases:

git-kit update

Update a specific profile:

git-kit update --profile power

Check installation

git-kit doctor

Check a specific profile:

git-kit doctor --profile minimal

Uninstall

Uninstall all managed aliases:

git-kit uninstall

Uninstall a specific profile:

git-kit uninstall --profile minimal

Remove all git-kit-managed includes and every managed file at once:

git-kit uninstall --all

Generate configs and docs

Regenerate the managed alias config files and documentation from the source alias definitions:

git-kit generate

This is primarily a development/maintainer command. Run it after modifying files in aliases/.

Configuration

git-kit writes a managed alias config file and adds a single [include] entry to your global Git config. Your existing aliases are not modified.

Managed files are stored at:

• macOS/Linux: ~/.config/git-kit
• Windows: %APPDATA%\git-kit

Profiles

| Profile | Description | | --- | --- | | minimal | Essential day-to-day aliases only | | lazy | Comfortable aliases for everyday development | | power | Full alias set for power users |

See docs/aliases.md for the complete alias reference.

Development

1. Install dependencies:

   bun install

2. Generate alias configs and docs:

   bun run generate

3. Run tests:

   bun test

4. Build:

   bun run build

5. Validate generated files are up to date:

   bun run validate

License

MIT