gitkit 0.3.1

Standalone CLI for configuring git repos — hooks, .gitignore, and .gitattributes
gitkit-0.3.1 is not a library. 
           ███   █████    █████       ███   █████   
          ░░░   ░░███    ░░███       ░░░   ░░███    
  ███████ ████  ███████   ░███ █████ ████  ███████  
 ███░░███░░███ ░░░███░    ░███░░███ ░░███ ░░░███░   
░███ ░███ ░███   ░███     ░██████░   ░███   ░███    
░███ ░███ ░███   ░███ ███ ░███░░███  ░███   ░███ ███
░░███████ █████  ░░█████  ████ █████ █████  ░░█████ 
 ░░░░░███░░░░░    ░░░░░  ░░░░ ░░░░░ ░░░░░    ░░░░░  
 ███ ░███                                           
░░██████                                            
 ░░░░░░

CI Release Crates.io License: MIT

Set up a git repo the way you actually work — one guided flow for hooks, .gitignore, .gitattributes, and git config. One binary, no Node.js, no Python, no runtime dependencies.

Demo

Demo

Features

  • 🪄 Guided repo setup — Configure hooks, .gitignore, .gitattributes, and git config in one interactive flow.
  • 🔁 Clone and bootstrap — Clone a repo and drop straight into the setup wizard.
  • 🧰 Hook management — Install, list, show, or remove built-in hooks, or wire up your own command.
  • 🧩 Ignore and attribute presets — Browse built-in and gitignore.io templates, then apply line-ending or binary presets.
  • ⚙️ Curated git config — Apply practical presets like auto-upstream, autocorrect, histogram diffs, zdiff3, rerere, and delta pager setup.
  • 📦 Single binary — No Node.js, no Python, no extra runtime.

Installation

Quick install (recommended)

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/UniverLab/gitkit/main/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/UniverLab/gitkit/main/scripts/install.ps1 | iex

Via cargo

cargo install gitkit

Available on crates.io.

GitHub Releases

Check the Releases page for precompiled binaries (Linux x86_64, macOS x86_64/ARM64, Windows x86_64).

Uninstall

Linux / macOS:

rm -f ~/.local/bin/gitkit

Windows (PowerShell):

Remove-Item "$env:LOCALAPPDATA\gitkit\gitkit.exe" -Force

Quick Start

Clone and configure a repo in one command:

gitkit clone https://github.com/user/repo

Or configure an existing repo:

gitkit init

Or use commands directly:

gitkit hooks add conventional-commits
gitkit ignore add rust,vscode,agentic
gitkit attributes init
gitkit config apply defaults

gitkit init

Interactive wizard that guides you through configuring a repo step by step.

  • Hooks — built-ins pre-selected, or add a custom command
  • .gitignore — filterable search across all gitignore.io templates + built-ins
  • .gitattributes — line endings and binary file presets
  • Git config — 6 individual options, recommended ones pre-selected

Automatically initializes a git repository if one doesn't exist:

gitkit init

gitkit clone

Clone a repository and automatically run gitkit init to configure it.

Usage:

gitkit clone [OPTIONS] <REPOSITORY> [DIRECTORY]

Arguments:

  • <REPOSITORY> — Repository URL or path to clone
  • [DIRECTORY] — Target directory (defaults to repository name)

Options:

  • -b, --branch <BRANCH> — Clone specific branch (defaults to repository default)
  • -h, --help — Print help

Examples:

# Clone and auto-configure
gitkit clone https://github.com/user/repo

# Clone specific branch
gitkit clone -b develop https://github.com/user/repo

# Clone to custom directory
gitkit clone https://github.com/user/repo my-project

The wizard runs automatically after cloning, allowing you to configure hooks, .gitignore, .gitattributes, and git config in one workflow.

Commands

Hooks

Command Description
gitkit hooks add <builtin> Install a built-in hook (hook name inferred)
gitkit hooks add <hook> <command> Install a custom shell command as a hook
gitkit hooks list List installed hooks
gitkit hooks list --available Show all built-in hooks with descriptions
gitkit hooks remove <hook> Remove an installed hook
gitkit hooks show <hook> Print hook content

Ignore

Command Description
gitkit ignore add <templates> Generate/merge .gitignore via gitignore.io
gitkit ignore list [filter] List available templates

Attributes

Command Description
gitkit attributes init Apply line endings preset to .gitattributes

Config

Command Description
gitkit config apply defaults push.autoSetupRemote, help.autocorrect, diff.algorithm
gitkit config apply advanced merge.conflictstyle zdiff3, rerere.enabled
gitkit config apply delta core.pager delta (requires cargo)

Built-in Hooks

Run gitkit hooks list --available to see these without leaving the terminal.

Name Hook Description
conventional-commits commit-msg Validates Conventional Commits format
no-secrets pre-commit Detects common secret patterns in staged changes
branch-naming pre-commit Validates branch name matches convention

Built-ins are embedded in the binary — no network required.

Global Flags

Flag Description
--yes, -y Skip confirmation prompts
--force, -f Overwrite existing files
--dry-run Preview changes without applying

License

MIT

Support

Made with ❤️ by JheisonMB and UniverLab