Supported Features

Here is a non-comprehensive table of git commands and features and their compatibility status with go-git.

Getting and creating repositories

Feature	Sub-feature	Status	Examples
`init`		✅
`init`	`--bare`	✅
`init`	`--template` `--separate-git-dir` `--shared`	❌
`clone`		✅	- PlainClone
`clone`	Authentication: - none - access token - username + password - ssh	✅	- clone ssh (private_key) - clone ssh (ssh_agent) - clone access token - clone user + password
`clone`	`--progress` `--single-branch` `--depth` `--origin` `--recurse-submodules` `--shared`	✅	- recurse submodules - progress

Feature	Status	Notes	Examples
`add`	✅	Plain add is supported. Any other flags aren't supported
`status`	✅
`commit`	✅		- commit
`reset`	✅
`rm`	✅
`mv`	✅

Feature	Status	Notes	Examples
`branch`	✅		- branch
`checkout`	✅	Basic usages of checkout are supported.	- checkout
`merge`	⚠️ (partial)	Fast-forward only
`mergetool`	❌
`stash`	❌
`sparse-checkout`	✅		- sparse-checkout
`tag`	✅		- tag - tag create and push

Feature	Sub-feature	Status	Notes	Examples
`fetch`		✅
`pull`		✅	Only supports merges where the merge can be resolved as a fast-forward.	- pull
`push`		✅		- push
`remote`		✅		- remotes
`submodule`		✅		- submodule
`submodule`	deinit	❌

Feature	Status	Notes
`apply`	❌
`cherry-pick`	❌
`diff`	✅	Patch object with UnifiedDiff output representation.
`rebase`	❌
`revert`	❌

Feature	Sub-feature	Status	Notes	Examples
`daemon`		❌
`update-server-info`		✅		cli

Feature	Sub-feature	Status	Notes	Examples
`git-verify-commit`		✅
`git-verify-tag`		✅

Feature	Sub-feature	Status	Notes	Examples
`cat-file`		✅
`check-ignore`		❌
`commit-tree`		❌
`count-objects`		❌
`diff-index`		❌
`for-each-ref`		✅
`hash-object`		✅
`ls-files`		✅
`ls-remote`		✅		- ls-remote
`merge-base`	`--independent` `--is-ancestor`	⚠️ (partial)	Calculates the merge-base only between two commits.	- merge-base
`merge-base`	`--fork-point` `--octopus`	❌
`read-tree`		❌
`rev-list`		✅
`rev-parse`		❌
`show-ref`		✅
`symbolic-ref`		✅
`update-index`		❌
`update-ref`		❌
`verify-pack`		❌
`write-tree`		❌

Feature	Version	Status
index	v1	❌
index	v2	✅
index	v3	❌
pack-protocol	v1	✅
pack-protocol	v2	❌
multi-pack-index	v1	❌
pack-*.rev files	v1	❌
pack-*.mtimes files	v1	❌
cruft packs		❌

Scheme	Status	Notes	Examples
`http(s)://` (dumb)	❌
`http(s)://` (smart)	✅
`git://`	✅
`ssh://`	✅
`file://`	⚠️ (partial)	Warning: this is not pure Golang. This shells out to the `git` binary.
Custom	✅	All existing schemes can be replaced by custom implementations.	- custom_http

Feature	Status	Notes	Examples
`init`	✅	Requires building with tag sha256.	- init
`commit`	✅	Requires building with tag sha256.	- commit
`pull`	❌
`fetch`	❌
`push`	❌

Feature	Sub-feature	Status	Notes
`config`	`--local`	✅	Read and write per-repository (`.git/config`).
`config`	`--global` `--system`	✅	Read-only.
`gitignore`		✅
`gitattributes`		✅
`git-worktree`		❌	Multiple worktrees are not supported.