heroku-cli-addons

heroku-cli-addons

This re-implements the heroku addons [--app APP|--all] command in Node with a new UX which aims to make the concepts clearer and the relationships between them more accessible.

Note: the commands are in the _addons namespace to avoid conflicting with the regular addons namespace until completed.

Some effort is made to be consistent with mock-ups and designs targeted to Dashboard. For example, these from @almonk:

Example output:

$ heroku _addons -a addons-reports
Add-on                              Plan                              Price
──────────────────────────────────  ────────────────────────────────  ───────────────────────────
flowing-tidily-5466                 heroku-postgresql:kappa           (billed to addons app)
 ├─ support-api::ADDONS_DATABASE
 ├─ ADDONS_DATABASE
 ├─ addons::HEROKU_POSTGRESQL_BLUE
 └─ addons::DATABASE
practicing-nobly-1495               heroku-postgresql:premium-yanari  $200/month
 ├─ DATABASE
 ├─ addons::ADDONS_REPORTS
 └─ HEROKU_POSTGRESQL_SILVER
swimming-truly-2371                 openredis:micro                   $8/month
 └─ OPENREDIS
cooling-avidly-8928                 ?                                 (billed to vault-usage app)
 └─ VAULT_USAGE

As an experiment, it also makes use of ANSI colours where appropriate, by highlighting reference types by consistent colours and dimming non-critical information:

Install

For now, since this isn't published on npm, you can install it like so:

$ git clone https://github.com/heroku/heroku-cli-addons.git heroku-cli-addons
$ cd heroku-cli-addons
$ npm install                # dependencies
$ heroku plugins:link

If you run into any problems, open an issue. You can remove the plugin in the meantime if it's borked:

$ rm ~/.heroku/node_modules/heroku-cli-addons