@simple-git/argv-parser
3.0.0 · 16 Nov 2026MIT11.7M / weekRepositorynpmAtom feed
8 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 3.x · latest line
3.0.0
16 Nov 2026Summary· from the note as AI read it
Upgrade: this release fixes a security issue.
- Security
Remove the
vulnerabilityCheckexport, useparseArgv(...tokens).vulnerabilitiesandparseEnv(env).vulnerabilities
instead. Each vulnerability now also carries theconfigKeyorenvKeythat triggered it.
Major Changes
- Security
Remove the
vulnerabilityCheckexport, useparseArgv(...tokens).vulnerabilitiesandparseEnv(env).vulnerabilities
instead. Each vulnerability now also carries theconfigKeyorenvKeythat triggered it.
Minor Changes
Add the
allowConfigandstrictoptions. Configuration keys outside the built-in list of known-safe keys
(SAFE_CONFIG_KEYS) and the keys named inallowConfignow emit a one-offSIMPLE_GIT_UNLISTED_CONFIGwarning,
or are rejected whenstrict: trueis set. Known-unsafe keys can now be permitted individually throughallowConfig, and environment variables throughallowEnvironment, deprecating theunsafe.allowUnsafe*options
that only covered configuration keys or environment variables (they continue to work as before).When the recommended checks are enabled (with
unsafe.recommended: trueorstrict: true),HOMEandXDG_CONFIG_HOME
supplied through.env()with a value other than the one inprocess.envrequireallowUnsafeConfigPaths
(or naming them inallowEnvironment), asgitreads the global configuration from$HOME/.gitconfigand$XDG_CONFIG_HOME/git/configin the same way asGIT_CONFIG_GLOBAL. Passing the inherited value through is unaffected,
and neither is removed from the inherited environment.parseEnvaccepts the inherited environment as an optional second argument, used to compareHOMEandXDG_CONFIG_HOMEagainst.isGuardedEnvKeyis now exported from@simple-git/argv-parser, identifying the environment variables
(GIT_*and the othersgitreads, such asEDITORandPAGER) thatsimple-gitremoves from an inherited
environment.Vulnerability reports:
With thanks to @manus-pi, @manus-use, @ba-am, @mspiq, @hoseinenddev, @freyesperales, @dalberrt,
@zer0d4y5, @gamster01, @humaneBicycle, @Hama1cco, @eliteaja11-dev, @Cone-Tester, @Figo5, @MalwareEZ,
@zachariah-mithani, @shaswata56, @Akokonunes for submitting CVE proposals that contributed to these changes.closing the loop on any configuration setting ending with
.cmdorcommandunder the catch-allallowUnsafeCommandBinariessetting (only enforced with the newunsafe.recommendedoption, orstrict), and blockinggpg.ssh.defaultKeyCommandunderallowUnsafeGpgProgram.allowUnsafePagerwill now catch setting a custom binary ingit grep --open-files-in-pager.allowUnsafePagernow also coversinteractive.diffFilter, the shell command thatgit add -pand the other--patchcommands pipe their diff through.new (deprecated on arrival, prefer
allowConfig)allowUnsafeSendEmailConfigoption covering thesendemail.*keys thatgit send-emailruns as commands, reads as files or uses to turn off certificate verification (sendmailCmd,toCmd,ccCmd,headerCmd,smtpServer,smtpServerOption,smtpSSLCertPath,smtpSSLClientCert,smtpSSLClientKey,aliasesFileandmailmap.file, including their per-identitysendemail.<identity>.*variants), and theimap.tunnel,imap.hostandimap.sslVerifykeys used bygit imap-send.new (deprecated on arrival, prefer
allowConfig)allowUnsafeWebServerConfigoption covering theinstaweb.httpd,instaweb.modulePathandinstaweb.gitwebDirkeys used bygit instaweb.new (deprecated on arrival, prefer
allowConfig)allowUnsafeBrowseroption covering thebrowser.<tool>.path,browser.<tool>.cmd,man.<tool>.pathandman.<tool>.cmdkeys used bygit helpandgit instawebto open a browser or man page viewer.browser.<tool>.cmdandman.<tool>.cmdwere previously covered byallowUnsafeCommandBinaries.new (deprecated on arrival, prefer
allowConfig)allowUnsafeSignatureTrustoption coveringgpg.ssh.allowedSignersFile,gpg.ssh.revocationFileandgpg.minTrustLevel, which decide which signatures pass verification.allowUnsafePacknow blocks--execfor every command other thanrebase, as it names the remote program forpush,send-pack,fetch-pack,archive --remoteandls-remote(previously onlypush).new
allowUnsafeConfigRenameoption blockinggit config --rename-section/git config rename-section, which could move keys written under a harmless section name (eg:foo.fsmonitor) into one that runs commands (core.fsmonitor).allowUnsafeExecnow also covers thegit filter-branchoptions that run a shell command:--setup,--env-filter,--tree-filter,--index-filter,--parent-filter,--msg-filter,--commit-filterand--tag-name-filter.allowUnsafeDiffExternalnow also coversdifftool.<tool>.path, matchingmergetool.<tool>.pathunderallowUnsafeMergeDriver.
- 2.x
2.0.1
26 Sep 2026Add
VISUALenvironment variable to set ofallowUnsafeEditorenvironment variables.
2.0.0
25 Sep 2026- Breaking
Updates ahead of the v4 release for
simple-git. - Security
Vulnerability detection expanded to include
pager.*,uploadpack.packObjectsHook,difftool.*.cmdand use of theGIT_CONFIG_PARAMETERSenvironment variable
Major Changes
- Breaking
Updates ahead of the v4 release for
simple-git.Adds support for TypeScript declaration maps
Exports the
isGitEnvKeyhelper to detect whether an environment variable can be used to configure agitoperationAdds detection for
includeIf.<condition>.path, thanks to @NotAFlightRisk for identifying the vulnerability
Patch Changes
- Security
Vulnerability detection expanded to include
pager.*,uploadpack.packObjectsHook,difftool.*.cmdand use of theGIT_CONFIG_PARAMETERSenvironment variable
- 1.x
1.1.1
13 Apr 2026Add backward compatible API, resolves issue caused by using simple-git@3.35.2 with @simple-git/argv-parser@1.1.0
1.1.0
12 Apr 2026Extend known exploitable configuration keys and per-task environment variables.
Note -
ParsedVulnerabilitiesfromargv-parseris removed in favour of a readonly array ofVulnerabilityto match usage insimple-git, rolled into the newvulnerabilityCheckfor simpler access to the identified issues.Update devDependencies
Minor Changes
Extend known exploitable configuration keys and per-task environment variables.
Note -
ParsedVulnerabilitiesfromargv-parseris removed in favour of a readonly array ofVulnerabilityto match usage insimple-git, rolled into the newvulnerabilityCheckfor simpler access to the identified issues.
Patch Changes
Update devDependencies
1.0.3
6 Apr 2026Improvements for mono-repo publishing pipeline
Patch Changes
Improvements for mono-repo publishing pipeline
1.0.2
6 Apr 2026Update monorepo version handling during publish
1.0.1
6 Apr 2026Updating publish config
Patch Changes
Updating publish config
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.