gitkit 0.2.0 - Docs.rs

gitkit-0.2.0 is not a library.

           ███   █████    █████       ███   █████   
          ░░░   ░░███    ░░███       ░░░   ░░███    
  ███████ ████  ███████   ░███ █████ ████  ███████  
 ███░░███░░███ ░░░███░    ░███░░███ ░░███ ░░░███░   
░███ ░███ ░███   ░███     ░██████░   ░███   ░███    
░███ ░███ ░███   ░███ ███ ░███░░███  ░███   ░███ ███
░░███████ █████  ░░█████  ████ █████ █████  ░░█████ 
 ░░░░░███░░░░░    ░░░░░  ░░░░ ░░░░░ ░░░░░    ░░░░░  
 ███ ░███                                           
░░██████                                            
 ░░░░░░

Configure a git repo in seconds — hooks, .gitignore, .gitattributes, and git config. Interactive wizard or direct commands. No Node.js, no Python, no runtime dependencies. One binary.

Installation

Quick install (recommended)

Linux / macOS:

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

Windows (PowerShell):

irm https://raw.githubusercontent.com/JheisonMB/gitkit/main/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

Interactive wizard — guided setup for a new 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

gitkit init

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