{"action":"closed","issue":{"url":"https://api.github.com/repos/bcoe/yargs/issues/188","labels_url":"https://api.github.com/repos/bcoe/yargs/issues/188/labels{/name}","comments_url":"https://api.github.com/repos/bcoe/yargs/issues/188/comments","events_url":"https://api.github.com/repos/bcoe/yargs/issues/188/events","html_url":"https://github.com/bcoe/yargs/issues/188","id":90437574,"number":188,"title":"Support for hidden commands","user":{"login":"tschaub","id":41094,"avatar_url":"https://avatars.githubusercontent.com/u/41094?v=3","gravatar_id":"","url":"https://api.github.com/users/tschaub","html_url":"https://github.com/tschaub","followers_url":"https://api.github.com/users/tschaub/followers","following_url":"https://api.github.com/users/tschaub/following{/other_user}","gists_url":"https://api.github.com/users/tschaub/gists{/gist_id}","starred_url":"https://api.github.com/users/tschaub/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tschaub/subscriptions","organizations_url":"https://api.github.com/users/tschaub/orgs","repos_url":"https://api.github.com/users/tschaub/repos","events_url":"https://api.github.com/users/tschaub/events{/privacy}","received_events_url":"https://api.github.com/users/tschaub/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-06-23T16:52:09Z","updated_at":"2015-06-28T01:21:58Z","closed_at":"2015-06-28T01:21:58Z","body":"There are cases where it would be nice to hide some commands from the help/usage output.  An example would be setup or post-install work that is not part of the typical user workflow (e.g. `completion`).  The help output becomes less useful when it is diluted with these one-time or setup type commands.\r\n\r\nThis could be supported by not adding usage for commands with `false` for a description.  E.g.\r\n```js\r\nyargs.command('post-install', false, handler);\r\n```\r\n\r\nIf someone wanted the `completion` command to not show up in the help doc, this could be made to work:\r\n```js\r\nyargs.completion('completion', false);\r\n```\r\n\r\nOnly commands that are registered with usage are eligible for completion, so \"hidden\" commands would not show up as completion candidates.  I think this is consistent with being hidden.\r\n\r\nPrior art:\r\n * [commander's `noHelp`](https://github.com/tj/commander.js/pull/383)\r\n * [nomnom's `hidden`](https://github.com/harthur/nomnom#hidden)\r\n * [argparse's `argparse.SUPPRESS`](https://docs.python.org/dev/library/argparse.html#help)\r\n"}}