NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #70 most downloaded on npm
yargs the modern, pirate-themed, successor to optimist.
Last release 11 days ago
20 Sep 2026
Ships unpredictably
gaps range from 2 weeks to 2.0 years
Most releases are documented
notes for 41 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
267 releases · first in 2013
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.
Nothing published for this version
- #344 yargs now has a code of conduct and contributor guidelines (@bcoe) - #341 Fix edge-case with camel-case arguments (@davibe) - #331 Handle parsi
- #239 Pass argv to commands (@bcoe) - #308 Yargs now handles environment variables (@nexdrew) - #302 Add Indonesian translation (@rilut) - #300 Add T
- #293 Polish language support (@kamilogorek) - #291 fix edge-cases with .alias() (@bcoe) - #289 group options in custom groups (@bcoe)
- #282 completions now accept promises (@LinusU) - #281 fix parsing issues with dot notation (@bcoe)
- #277 adds support for ansi escape codes (@bcoe)
- #271 skips validation for help or version flags with exitProcess(false) (@tepez) - #273 implements single output for errors with exitProcess(false)
- #263 document count() and option() object keys (@nexdrew) - #259 remove util in readme (@38elements) - #258 node v4 builds, update deps (@nexdrew) -
- #254 adds Japanese translation (@oti) - #253 fixes for tests on Windows (@bcoe)
- #248 reinstate os-locale, no spawning (@nexdrew) - #249 use travis container-based infrastructure (@nexdrew) - #247 upgrade standard (@nexdrew)
- #246 detect locale based only on environment variables (@bcoe) - #244 adds Windows CI testing (@bcoe) - #245 adds OSX CI testing (@bcoe, @nexdrew)
Nothing published for this version
Nothing published for this version
- #242 adds detectLocale config option (@bcoe)
- #240 hot-fix for Atom on Windows (@bcoe)
- #238 upgrade camelcase, window-size, chai, mocha (@nexdrew) - #237 adds defaultDescription to option() (@nexdrew)
- #231 Merge pull request #231 from bcoe/detect-locale (@sindresorhus) - #235 adds german translation to yargs (@maxrimue)
- #224 added Portuguese translation (@codemonkey3045)
- #228 notes about embedding yargs in Electron (@etiktin) - #223 make booleans work in config files (@sgentle)
- #222 updates fr locale (@nexdrew) - #221 adds missing locale strings (@nexdrew) - #220 adds es locale (@zkat)
- #218 upgrades nyc (@bcoe)
Nothing published for this version
- #210 adds i18n support to yargs (@bcoe) - #209 adds choices type to yargs (@nexdrew) - #207 pretty new shields from shields.io (@SimenB) - #208 impr
- #197 tweaks to how errors bubble up from parser.js (@bcoe) - #193 upgraded nyc, reporting now happens by default (@bcoe)
- #192 standard style nits (@bcoe) - #190 allow for hidden commands, e.g., .completion('completion', false) (@tschaub)
- #187 completion now behaves differently if it is being run in the context of a command (@tschaub) - #186 if no matches are found for a completion de
- #183 don't complete commands if they've already been completed (@tschaub) - #181 various fixes for completion. (@bcoe, @tschaub) - #182 you can now
- #173 update standard, window-size, chai (@bcoe) - #171 a description can now be set when providing a config option. (@5c077yP)
- #165 expose yargs.terminalWidth() thanks @ensonic (@bcoe) - #164 better array handling thanks @getify (@bcoe)
b6662b6 clarify .config() docs (@linclark)
- #157 Merge pull request #157 from bcoe/command-yargs. allows handling of command specific arguments. Thanks for the suggestion @ohjames (@bcoe) - #1
- #154 showHelp's method signature was misleading fixes #153 (@bcoe) - #151 refactor yargs' table layout logic to use new helper library (@bcoe) - #15
679fbbf updated yargs to use the standard style guide (agokjr)
89e1992 detect iojs bin along with node bin. (@bcoe)
56cbe2d make .requiresArg() work with type hints. (@bcoe).
4e24e22 support for .js configuration files. (@pirxpilot)
c16cc08 message for non-option arguments is now optional, thanks to (@raine)
870b428 completion script was missing in package.json (@bcoe)
58a4b24 parse was being called multiple times, resulting in strange behavior (@bcoe)
4e588e0 accidentally left testing logic in (@bcoe)
718bacd added support for bash completions see #4 (@bcoe)
a758e0b fix for count consuming too many arguments (@bcoe)
0476af7 added nargs feature, allowing you to specify the number of arguments after an option (@bcoe)
Nothing published for this version
ad485ce fix for applying defaults to camel-case args (@bcoe)
49a6d18 you can now provide a function that generates a default value (@bcoe)
9bd2379 version now accepts a function, making it easy to load version #s from a package.json (@bcoe)
0b7c19b various fixes for dot-notation handling (@bcoe)
c3f35e9 make sure dot-notation is applied to aliases (@bcoe)
added the command option, which allows you to document the commands that your application accepts:
command option, which allows you to document the commands that your application accepts:var argv = require('yargs')
.command('upgrade', 'upgrade the current version of the application')
.argv;
epilogue option, which allows you to specify a final line of text that your application should output. see: https://github.com/chevex/yargs/issues/14array option (similar to string, or boolean), tells the parser to always interpret a key as an array, even when only a single value is given..check() will now fail if any non-truthy value is returned. see: https://github.com/chevex/yargs/issues/76Nothing published for this version
Nothing published for this version
d824620 allow for undefined boolean defaults (@ashi009)
01c6c61 fix for #71, 'newAliases' of undefined (@bcoe)
Nothing published for this version
- b8d3472 1.3.2 (@chevex)
Your coding agent can read these notes before it upgrades. Set up the MCP server →