Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Commands

gkit uses noun-style subcommands, in two layers.

SSH key layer — start here

Every workflow begins with an ssh identity: you need a key on the host before you can clone anything. This layer is repo-independent — it manages keys and the gkit-owned ~/.ssh/git_users.

CommandSummary
keyGenerate id_<alias> ssh keys, copy a public key, and manage ~/.ssh/git_users.

Repo layer — the everyday loop

Once a key is in place, these act on git repositories (a single repo or a whole fleet from a conf):

CommandSummary
initScaffold a starter clone conf in the current directory.
cloneClone the repos in a conf file, with hooks and transparent commands.
logoffGate: is every repo + submodule committed and pushed?
stmbSwitch to the base branch and safe-delete a finished feature, recursively.

Run gkit <command> --help for the authoritative flag list.