Git command parity

init Creates .kit/ instead of .git/. It takes no argument and no flag. In an existing repository it fails, where Git reinitializes.

add Pathspecs, -A, -u, -f and -p (interactive hunk staging). -n and --dry-run are not implemented.

status --porcelain (v1 and v2), -s and -z match Git, with 64-hex IDs. A path with special bytes is quoted as in Git. kit lists each untracked file. Git lists an untracked directory as dir/.

diff --staged, --cached, --name-only, --name-status, --stat, -w, -b, -U<n>, -z, --exit-code, --quiet, --color and ranges. Without a revision, kit compares HEAD with the working tree, with staged and untracked files. Git compares the index with the working tree.

commit -m, -F, -a, --amend, --author and -q. Every commit is signed. --author takes a key identity such as ed25519:<hex>. kit makes a commit when nothing changed. Git refuses without --allow-empty, which kit does not have.

rm --cached, -r and -f. Refuses to delete a modified file without -f.

mv Moves a file or a directory, also into a directory. -f overwrites the destination. status and diff show a move as R.

checkout / switch checkout -b and -B, switch -c and -C create a branch. Both refuse to overwrite modified files. checkout takes a branch or a revision, not a path. Use restore for files.

restore / reset restore: --staged, --worktree, --source. reset: --soft, --mixed, --hard. restore and reset --hard refuse to discard edits without -f, where Git discards them. reset --mixed does not list the unstaged changes.

branch Create, list, -v, --show-current, -d, -D, -m, --merged, --contains and name patterns. -r, -a, -u and --unset-upstream are not implemented.

tag Lightweight, -a, -s, -m, -d and -l <pattern>. The list shows the name, the short ID and the kind. Git shows the names.

merge --no-commit, -m, --continue and --abort. The messages match Git. Conflict markers read ours and theirs. Git writes HEAD and the branch name.

cherry-pick -n, -m, --continue and --abort.

rebase <branch>, --continue, --abort, --skip and -i with reorder, drop, reword, squash and fixup. --onto and the edit action are not implemented.

revert <commit>, -n, --continue and --abort. kit does not revert a merge commit and has no -m.

log Ranges, -n, --oneline, --abbrev-commit, --abbrev, --format=json, --author, --grep, --since, --until, --no-merges and --first-parent. --author and --grep match a substring. --since and --until read a fixed set of date forms. -p, --stat, --decorate, --all and --graph are not implemented. The header shows a key identity and a UTC date.

show Commits, tags and blobs, and --stat. <rev>:<path> and -s are not supported.

reflog Lists the first-parent chain of a branch as <ref>@{N}. It does not record operations, and it omits commits that amend or reset replaced.

blame -L, a revision, -w, -M, -C, --ignore-rev, --reverse, --porcelain and --line-porcelain. The default line is <short id>, <line number>, <text>. The porcelain author fields hold a key identity, and there is no previous line. --ignore-rev-precise is only in kit.

bisect start, good, bad, skip, reset and run <cmd>. kit prints each candidate and does not check it out. HEAD stays on your branch. Git checks out each candidate.

worktree add, list, remove and prune. All trees share one object store and the refs. A branch is in at most one tree. remove refuses a tree with changes or untracked files without --force. move, lock and repair do not exist.

sparse-checkout set, list, disable and reapply. set keeps files already in the working tree. reapply does not create a file that a pattern excludes, and status lists that file as deleted.

stash save, list, pop, apply, drop, clear and show, with --index. Each linked worktree has its own stash. Git shares one stash. push and --include-untracked are not implemented.

clean -n, -f, -d, -x and -X. Refuses to run without -f.

gc Prunes unreachable objects after a grace period. -n previews and --grace-secs sets the period. Git gc has no -n.

rev-parse --short, --abbrev-ref and --show-toplevel. --verify and <rev>:<path> are not supported.

cat-file -t, -s, -p and --batch. A missing object prints <name> missing.

ls-files / ls-tree ls-files: -s, -z, --others, --ignored and --exclude-standard. ls-tree: -r. The output matches Git except for the ID length.

show-ref --heads and --tags. A ref pattern argument is not supported.

for-each-ref --format with %(atom) fields and a ref pattern.

symbolic-ref / update-ref symbolic-ref reads or repoints HEAD. update-ref takes an old value for compare-and-swap. update-ref -d refuses to delete the current branch. Git deletes it.

merge-base <a> <b> prints the common ancestor. --is-ancestor sets the exit code.

rev-list Takes one revision. --count prints the number. Ranges and --max-count are not supported.

remote List, -v, add, remove, rename, get-url and set-url. A URL starts with kit+<scheme>://. A plain URL or path is an error. The default remote is named default, not origin.

push Pushes the current branch, or all branches with --all. -u, --force-with-lease, -f and --dry-run work. The summary has the shape of Git. kit has no refspec, --tags or --delete.

pull / fetch The summary has the shape of Git. --all covers every remote. pull fast-forwards only. --rebase, --no-ff, --prune and --tags are not implemented.

clone -b <branch> and -o <name>. --depth fails with a usage error.

on-disk and wire interop with .git A BLAKE3 object store cannot share bytes with a SHA-1 object store. kit translates objects with kit git export and kit git import. Two-way sync is not planned.

config Reads and writes a fixed set of keys, with --unset, --local and --global. -c sets a key for one command. user.name, user.email and core.* are unknown keys and fail. A repository cannot hold the signing key.

ignore files Reads .gitignore and .kitignore at the repository root. Negation works. add -f stages an ignored path. kit does not read ignore files in subdirectories.