simple-git
4.1.0 · 16 Nov 2026MIT15.5M / weekRepositorynpmAtom feed
278 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 3.x
3.1.1
26 Jan 2022Specify repository with
directoryidentifier to be discoverable within monorepo
3.0.3
20 Jan 2022Allow branches without labels
Implement v3 deprecations
Publish v3 as
latest
3.0.2
18 Jan 2022Backward compatibility - permit loading
simple-git/promisewith deprecation notice until mid-2022.
3.0.1
18 Jan 2022Documentation update
- 2.x
2.48.0
1 Dec 2021StatusResultreturned bygit.status()should includedetachedstate of the working copy.Add example for empty commit message in
git.commit()
2.47.1
29 Nov 2021Maintenance only: docs, tests, build or refactoring. Nothing changes in how you use it.
2.47.0
19 Oct 2021git-grep
2.46.0
29 Sep 2021completionplugincompletionplugin to allow configuring whensimple-gitdetermines thegittasks to be complete.
2.45.1
4 Sep 2021Support progress events in locales other than western european character sets.
2.45.0
27 Aug 2021Use author email field that respects mailmap
getConfig always returns
nulldespite values being present in configuration
2.44.0
14 Aug 2021Add support for getting the current value of a git configuration setting based on its name.
2.43.0
13 Aug 2021Task callback types defined as single function type
2.42.0
31 Jul 2021Move
logtask to separate task builderSupport
scopeargument inlistConfigto return a specific scope's configuration
2.41.2
29 Jul 2021Use literal
trueandfalseinDiffResultTextFile | DiffResultBinaryFileto aid type assertions.
2.41.1
11 Jul 2021Commit parsing should cater for file names with square brackets
2.41.0
11 Jul 2021Allow setting the scope of
git config addto work on thelocal,globalorsystemconfiguration.Allow setting the scope of git config add to work on the
local,globalorsystemconfiguration.
2.40.0
14 Jun 2021Create the
spawnOptionsplugin to allow settinguid/gidowner for the spawnedgitchild processes.
2.39.0
13 May 2021git.cwdcan now be configured to affect just the chain rather than root instance.
2.38.0
14 Apr 2021Support enabling / disabling
debuglogs programmatically.
2.37.0
15 Mar 2021errorDetectionPluginto handle creating error messages when tasks fail.
2.36.1
7 Mar 2021Documentation update for
outputHandlerSupport parsing
git.branchwhere branches have carriage returns in the commit detail.
2.36.0
3 Mar 2021Timeout Plugin
Fix broken link in
no-responseauto-generated comment
2.35.2
23 Feb 2021Progress plugin should request progress events for fetch as well as other common long running tasks.
Bug Fixes
Progress plugin should request progress events for fetch as well as other common long running tasks.
- Deprecated
While use of the
ListLogSummarytype is deprecated in favour of the newLogResult, the alias type should also support the default genericDefaultLogFieldsto allow downstream consumers to upgrade to newer2.xversions without the need to specify a generic. (508e602), closes #586
2.35.0
16 Feb 2021Progress Handler
2.34.2
7 Feb 2021Fix npm publish token definition
2.32.0
4 Feb 2021Supports passing configuration arguments to the
gitbinary (via its-cargument as a prefix to any other arguments). Eg: to supply some custom http proxy to agit pullcommand, usesimpleGit('/some/path', { config: ['http.proxy=someproxy'] }).pull()Add deprecation notice to
git.silentInternal Updates:
2.31.0
17 Dec 2020Adds a
root: booleanproperty to theCommitResultinterface representing whether the commit was a 'root' commit (which is a commit that has no parent, most commonly the first commit in a repo).
2.30.0
16 Dec 2020Reinstates native support for node.js v10 by removing use of ES6 constructs
2.29.0
15 Dec 2020Update type definition for
git.mergeFromToto be theMergeResultreturned when using the more genericgit.mergemethod.
2.28.0
15 Dec 2020Adds support for
git.applyPatchto apply patches generated in agit diffto the working index, TypeScript consumers can make use of theApplyOptionstype definition to make use of strong types for the supported options. Thanks to @andreterron for the pull request.
2.28.0 Add support for
git apply& TypeScript Integration TestsAdds support for
git.applyPatchto apply patches generated in agit diffto the working index, TypeScript consumers can make use of theApplyOptionstype definition to make use of strong types for the supported options. Thanks to @andreterron for the pull request.
2.27.0
11 Dec 2020Update the
git.statusparser to account for staged deleted/modified files and staged files with subsequent modifications meaning a status of:
2.26.0
9 Dec 2020- Deprecated
Resolves an issue whereby using
git.logwith a callback (or awaiting the promise created from the now deprecatedsimple-git/promiseimport) would fail to return the response to the caller.
2.25.0
8 Dec 2020When using
git.commit, the first argument must be a string or array of strings. Passing another data type has long been considered an error, but now a deprecation warning will be shown in the log and will be switched to an error in version 3.Fixes an issue in
git.commitwhereby a commit that included only deleted lines would be parsed as though the deletions were inclusions.
2.25.0 TypeScript Types & Unit Tests, Commit Parsing
When using
git.commit, the first argument must be a string or array of strings. Passing another data type has long been considered an error, but now a deprecation warning will be shown in the log and will be switched to an error in version 3.Fixes an issue in
git.commitwhereby a commit that included only deleted lines would be parsed as though the deletions were inclusions.
2.24.0
27 Nov 2020pull,pushandpushTagsparameter types updated to match new functionality and tests switched to TypeScript to ensure they are kept in sync
2.23.0
20 Nov 2020- Deprecated
Upgrade
debugdependency and remove use of now deprecateddebug().destroy() Renames the default source branch from
mastertomain
2.21.0
7 Oct 2020Adds
stringto the set of types supported as options forgit.log
2.21.0 add
stringtoLogOptionstypeAdds
stringto the set of types supported as options forgit.log
2.20.1
24 Aug 2020LogOptionsshould be intersection rather than union types
2.20.0
24 Aug 20202.19.0
21 Aug 2020Move the command/task option processing function to TypeScript
2.18.0
19 Aug 2020git.cloneandgit.mirrorrewritten to fit the TypeScript tasks style.Resolves issue whereby
git.clonedidn't accept an object of options despite being documented as supporting.
2.17.0
3 Aug 2020git pull(and by extensiongit merge) adds remote message parsing to thePullResulttypeRemote message parsing adds property
remoteMessages.objectsof typeRemoteMessagesObjectEnumerationto capture the objects transferred in fetch and push.
2.16.0
2 Aug 2020git.mvrewritten to fit the TypeScript tasks style.Set up github actions for CI
2.15.0
23 Jul 2020- Deprecated
Renames some interfaces for consistency of naming, the original name remains as a type alias marked as
@deprecateduntil version 3.x: Adds the
TaskParsertype to describe a task's parser function and creates theLineParserutility to simplify line-by-line parsing of string responses.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.