Skip to content

quickstart.md

Latest commit

 

History

History
76 lines (56 loc) · 1.74 KB

quickstart.md

File metadata and controls

76 lines (56 loc) · 1.74 KB
Raw
title Quick Start
description The wizard, the status overview, and clone-and-configure in one command.
order 3

Quick Start

The wizard

Run gitkit with no arguments inside (or outside) a repository:

gitkit
# or explicitly:
gitkit init

The wizard guides you step by step and shows what is already configured:

  • Hooks — shows installed hooks, pre-selects them, allows removal.
  • .gitignore — filterable search across all gitignore.io templates plus built-ins.
  • .gitattributes — line endings and binary file presets.
  • Git config — shows current values, allows removal.
  • Custom hooks — interactive picker for hook type selection.

If the current directory is not a git repository, gitkit initializes one automatically.

Clone and configure in one command

gitkit clone https://github.com/user/repo            # clone + wizard
gitkit clone -b develop https://github.com/user/repo # specific branch
gitkit clone https://github.com/user/repo my-project # custom directory

The wizard runs automatically after cloning.

Direct commands

Everything the wizard does is also available as direct commands:

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

Check the result

gitkit status
Hooks:
  ✓ conventional-commits (commit-msg)
  ✓ custom: pre-push → "cargo test"

.gitignore:
  ✓ 14 patterns

.gitattributes:
  ✓ line-endings (eol=lf)

Git config (global):
  ✓ push.autoSetupRemote = true
  ✓ help.autocorrect = prompt
  ✓ diff.algorithm = histogram

When you are happy with a setup, save it as a build and apply it to every future project with one command.