@heroku-cli/plugin-orgs

CLI to manage Heroku Organizations

Usage no npm install needed!

<script type="module">
  import herokuCliPluginOrgs from 'https://cdn.skypack.dev/@heroku-cli/plugin-orgs';
</script>

README

Heroku Orgs CLI CircleCI

Code Climate codecov npm version License

js-standard-style

Available commands

https://github.com/heroku/heroku-orgs/blob/master/index.js.

Development

First, please read Developing CLI Plugins on Heroku's DevCenter.

Run Tests

$ npm test

Deploy

  1. Release a new version of this npm package.
$ npm version patch/minor/major
  1. Open a new pr in https://github.com/heroku/cli/blob/master/package.json, updating to the appropriate heroku-orgs version.

Commands

heroku access

list who has access to an app

USAGE
  $ heroku access

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use
  --json               output in json format

heroku access:add EMAIL

add new users to your app

USAGE
  $ heroku access:add EMAIL

OPTIONS
  -a, --app=app                  (required) app to run command against
  -p, --permissions=permissions  list of permissions comma separated
  -r, --remote=remote            git remote of app to use

EXAMPLES
  $ heroku access:add user@email.com --app APP # add a collaborator to your app
  $ heroku access:add user@email.com --app APP --permissions deploy,manage,operate # permissions must be comma separated

heroku access:remove EMAIL

remove users from a team app

USAGE
  $ heroku access:remove EMAIL

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

EXAMPLES
  $ heroku access:remove user@email.com --app APP

heroku access:update EMAIL

update existing collaborators on an team app

USAGE
  $ heroku access:update EMAIL

OPTIONS
  -a, --app=app                  (required) app to run command against
  -p, --permissions=permissions  comma-delimited list of permissions to update (deploy,manage,operate)
  -r, --remote=remote            git remote of app to use

EXAMPLES
  $ heroku access:update user@email.com --app APP --permissions deploy,manage,operate

heroku apps:join

add yourself to an organization app

USAGE
  $ heroku apps:join

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

heroku apps:leave

remove yourself from an organization app

USAGE
  $ heroku apps:leave

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

heroku apps:lock

prevent organization members from joining an app

USAGE
  $ heroku apps:lock

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

heroku apps:transfer RECIPIENT

transfer applications to another user or team

USAGE
  $ heroku apps:transfer RECIPIENT

ARGUMENTS
  RECIPIENT  user or team to transfer applications to

OPTIONS
  -a, --app=app        app to run command against
  -l, --locked         lock the app upon transfer
  -r, --remote=remote  git remote of app to use
  --bulk               transfer applications in bulk

DESCRIPTION

  Examples:

       $ heroku apps:transfer collaborator@example.com
       Transferring example to collaborator@example.com... done

       $ heroku apps:transfer acme-widgets
       Transferring example to acme-widgets... done

       $ heroku apps:transfer --bulk acme-widgets
       ...

heroku apps:unlock

unlock an app so any organization member can join

USAGE
  $ heroku apps:unlock

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

heroku join

add yourself to an organization app

USAGE
  $ heroku join

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

heroku leave

remove yourself from an organization app

USAGE
  $ heroku leave

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

heroku lock

prevent organization members from joining an app

USAGE
  $ heroku lock

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

heroku members

list members of an organization or a team

USAGE
  $ heroku members

OPTIONS
  -r, --role=role  filter by role
  -t, --team=team  team to use
  --json           output in json format
  --pending        filter by pending team invitations

heroku members:add EMAIL

adds a user to an organization or a team

USAGE
  $ heroku members:add EMAIL

OPTIONS
  -r, --role=role  (required) member role (admin, collaborator, member, owner)
  -t, --team=team  team to use

heroku members:remove EMAIL

removes a user from an organization or a team

USAGE
  $ heroku members:remove EMAIL

OPTIONS
  -t, --team=team  team to use

heroku members:set EMAIL

sets a members role in an organization or a team

USAGE
  $ heroku members:set EMAIL

OPTIONS
  -r, --role=role  (required) member role (admin, collaborator, member, owner)
  -t, --team=team  team to use

heroku orgs

list the organizations that you are a member of

USAGE
  $ heroku orgs

OPTIONS
  --enterprise  filter by enterprise orgs
  --json        output in json format
  --teams       filter by teams

heroku orgs:open

open the organization interface in a browser window

USAGE
  $ heroku orgs:open

OPTIONS
  -t, --team=team  team to use

heroku teams

list the teams that you are a member of

USAGE
  $ heroku teams

OPTIONS
  --json  output in json format

heroku unlock

unlock an app so any organization member can join

USAGE
  $ heroku unlock

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use