atmos / heroku-cli-addons

The core Heroku CLI plugin supplying functionality for working with Add-ons.

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.

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

Latest dev version

$ 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

Developing

$ npm install                     # install all dependencies
$ npm test                        # run the tests
$ npm version <major|minor|patch> # bump the version number and publish to npm